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About This Manual 



The CDCNET Systems Programmer's Reference Manual describes the CDC® Control 
Data Distributed Communications Network (CDCNET) software. The CDCNET software 
enables you to write new terminal interface programs (TIP) and gateway software to 
support terminals, networks and devices not currently supported by Control Data. 

Audience 

The Systems Programmer's Reference Manual is intended for anyone who will develop 
or integrate new software that is compatible with CDCNET. An understanding of the 
software described in this manual can be useful to programmers who intend to write 
new terminal interface programs or gateways for CDCNET. This includes writing of 
new applications, TIPs for terminals not already supported by CDCNET, and gateways 
to networks using protocols foreign to CDCNET. The reader is assumed to be familiar 
with CDCNET network operations. 

Organization 

This manual is one of a three-volume Systems Programmer's Reference Manual set that 
describes the CDCNET software. The following subsection contains brief descriptions of 
the other manuals in the set and a more detailed description of this manual. 

Systems Programmer's Reference Manual Set 

The three-volume manual set includes the following manuals. 

• Volume 1: Base System Software 

• Volume 2: Network Management Entities and Layer Interfaces 

• Volume 3: Network Protocols 

Base System Software, volume 1, describes the CDCNET Device Interface (DI) startup 
and system management software: its base system software. The volume begins with an 
overview of each base system software component, and continues with details of the 
procedures and functions provided by these software components for general use. 

Network MEs and Layer Interfaces, volume 2, describes each of the network 
management entities (MEs) and layer interfaces for CDCNET. The volume also 
describes the interfaces to non-CDCNET systems. These interfaces include interfaces to 
NOS hosts and X.25 Packet level networks. The information described in this volume is 
essential for programmers who intend to write gateway software that will reside in 
CDCNET. 

Network Protocols, volume 3, defines CDCNET network protocols. The use of protocols 
enforces consistent communication between software entities and the transitions that 
result. The description of each protocol follows a rigid documentation guideline, called 
the Finite State Machine (FSM). The information described in this volume will be 
useful to programmers implementing Control Data Network Architecture (CDNA) on a 
foreign host or network. 
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Volume 1: Base System Software 

This manual begins with a general introduction of the role CDCNETS's base system 
software plays within the network architecture. This software is then described in 
detail. Base system software procedures and functions that can be called are then 
presented in alphabetical order with the information needed to call them. Other 
relevent information is presented in the appendices, including the common types used 
in making procedure calls. 

Chapter 1 introduces the role of CDCNET's base system software within the network 
architecture. 

Chapter 2 describes the process of initializing a CDCNET system. 

Chapter 3 describes the general concepts and software management areas controlled by 
the executive software. 

Chapter 4 describes the software providing statistics management services. 

Chapter 5 describes the software providing status management services. 

Chapter 6 describes the software providing table management services. 

Chapter 7 describes the software providing the online loader. 

Chapter 8 describes the software providing failure management. 

Chapter 9 describes the Device Manager, which provides the interface between CDNA's 
physical and link layers. 

Chapter 10 describes the common routines of the base system software that provide the 
services described in the previous chapters. 

Appendix A provides a glossary of CDCNET terms and acronyms. 

Appendix B provides definitions of descriptor and data buffers. 

Appendix C provides an alphabetical list of CYBIL-defined common types discussed in 
this manual. 
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Additional Related Publications 

The following manuals are referenced in this document. These manuals should be used 
when more extensive information about the topics covered herein is required. 

Manual Title Publication 
Number 

CDCNET Network Analysis Manual 60461590 

CDCNET Troubleshooting Guide 60462630 

Ordering Manuals 

Control Data manuals are available through Control Data Sales offices or through: 

Control Data Corporation 
Literature Distribution Services 
308 North Dale Street 
St. Paul, Minnesota 55103 

Submitting Comments 

Control Data welcomes your comments about this manual. Your comments may include 
your opinion of the usefulness of this manual, your suggestions for specific 
improvements, and the reporting of any errors you have found. 

You can submit your comments on the comment sheet on the last page of this manual. 
If the manual has no comment sheet, mail your comments on another sheet of paper 
to: 

Control Data Corporation 

Technology and Publications Division, ARH219 

4201 Lexington Avenue North 

St. Paul, Minnesota 55126-6198 

You can also submit your comments through SOLVER, an online facility for reporting 
problems. To submit a documentation comment through SOLVER, do the following: 

1. Select Report a new problem or change in existing PSR from the main SOLVER menu. 

2. Respond to the prompts for site-specific information. 

3. Select Write a comment about a manual from the new menu. 

4. Respond to the prompts. 

Please indicate whether you would like a written response. 



8 Base System Software Revision A 



Introduction 



Introduction 



CDCNET Device Interfaces (DIs) manage the exchange of information between network 
interfaces. Information being moved from point A to point B on the network must be 
packaged and repackaged on its way. The data doesn't simply move horizontally across 
the network on the same level at which it came in. It must also move down through 
the network layers to the physical layer and back up again; otherwise, it cannot 
traverse the network. 

Moving information both horizontally and vertically through the network requires the 
specialized services of CDCNET management entities (MEs) and layer software. These 
services, in turn, must rely on base system software to provide the necessary 
environment for their activities. Base system software creates and maintains the 
system environment in a CDCNET DI. Without it, the system's MEs and layer software 
could not function. 

Base system software creates an operational environment in a DI by taking advantage 
of the distributed processing design of CDCNET. Working on a buddy system, DI 
software requesting help to initialize gets that help from an already operational DI. 
Software that is loaded in this way continues the initialization process from within the 
initializing DI. Initialization is complete when the DI is up and running normally. 

While a DI is operating normally, its base system software maintains the system 
environment for the MEs and layer software to use. Maintaining this environment 
means providing the following services: 

• Integer- and string-keyed table management 

• Allocation and de-allocation of system resources 

• Online loading 

• Device status table management 

• External device interrupt management 

• Comprehensive failure management 

• Collection and reporting of statistics 



The primary purpose of this manual is to provide enough information to enable you to 
use common base system software routines in your TIPs, gateways, or other 
CDCNET-compatible software. These routines are detailed in chapter 10. Between here 
and chapter 10, you will read about the special concepts and activities of CDCNET 
base system software components. This information is provided in the context of what 
these components can do for you in your own programming. 
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System Initialization 



The initialization process defines how the software is initially loaded and started in a 
CDCNET system. This process is designed to accommodate a first-time load as well as 
the needs of restoring a failed system to its operational state. CDCNET system 
initialization is a distributed process that requires the services of another, operational 
system. The initialization process consists of the following steps: 

• After DI power is turned on or the DI is reset, the hardware quicklook diagnostics 
are run. If the diagnostics complete successfully, control is transferred to the 
Dl-resident Main Bootstrap Controller. 

• The Main Bootstrap Controller selects a board across which to attempt a bootstrap 
and moves board-specific ROM code from that board into system main memory 
(SMM) to begin the bootstrap process. 

• The Dl-resident Initialization Bootstrap is then called to assist in loading across the 
selected board. This subroutine requests help in loading from an operational DI or 
host system. If a Terminal DI (TDI) is initializing, it looks to a Mainframe DI 
(MDI) for help. If an MDI or Mainframe Terminal Interface (MTI) is initializing, it 
looks to the host. 

The operational system determines if memory is to be dumped from the initializing 
system, based on information contained in the help request. If a dump is required, 
it is written to a file on the host before the loading is attempted. The boot file is 
then loaded into the initializing DI. 

• Once the boot file has been loaded into DI memory, the Initialization Bootstrap 
transfers control to the transfer address provided by the board-specific routine. This 
corresponds to the Initial Loader, which is the first section of the boot image; it 
arrives prelinked and ready for execution. 

The Initial Loader (described in more detail later) allocates memory and links the 
remaining software modules in the boot image. It then initializes the Executive and 
starts the System Ancestor as a task. 

• The System Ancestor, in turn, starts the basic set of tasks common to all DI 
variants, plus the software required to drive the network interface that was used in 
the initial load. When the System Ancestor completes its initialization function, the 
minimum set of system tasks required to support the DI environment has been 
started. 

• Among the tasks started by the System Ancestor is the Configuration Procurer. The 
Configuration Procurer oversees the starting and execution of configuraton 
commands that are specific to the DI being initialized. 

The Initial Loader 

The Initial Loader is the first section of the boot file to be loaded into the DI during 
initialization. It is loaded as a prelinked, absolute record that is ready for execution. 
The Initial Loader is immediately followed in the boot image by the other DI software 
modules. 

The Initial Loader loads the software modules from the boot image into the memory 
space of the DI hardware configuration (making the necessary linkages) and initiates 
software execution. Initiating software execution requires initialization of the Executive 
and startup of the System Ancestor task. 
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Program Naming Conventions 

There are three hardware boards that serve as storage locations for programs that will 
run on the MPB processor: the MPB itself, the Private Memory Module (PMM), and 
the System Main Memory (SMM). The following naming convention is used to ensure 
proper software module loading in the available hardware configuration. 

program _name_ MPB Preferred residence is in MPB memory. 

program_name_PMM Preferred residence is in PMM memory. 

Allocation of MPB, PMM, and SMM is hierarchical in that order. If there is not 
enough PMM, for example, a program with a PMM suffix will be placed in the SMM. 
If a program does not have a recognizable suffix to its name, the loader assumes that 
the program is to be stored in the SMM. 

NOTE 

Because the modules are examined and loaded sequentially from the boot image, 
modules that have a critical need for residence in the limited space of the MPB or the 
PMM should be placed early in the boot file so that they will be loaded early. For 
example, the Executive (EXEC _ MPB) is the first record in the boot image after the 
Initial Loader. 
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The Executive 



The Executive offers procedures that let users share the system's available processing 
and memory resources efficiently. It is the kernel of the DI software. 

This chapter presents some general concepts that apply to the Executive and goes on to 
give brief descriptions of the five specialized services that the Executive provides to its 
users. They are: 

• Task Management 

• Memory Management 

• Message Management 

• Queue Management 

• Timer Management 

General Concepts Relating to the Executive 

Interrupt Service Routines 

To achieve needed flexibility, the Executive distinguishes between two types of 
processing requests: Interrupt Service Routines and tasks. 

Interrupt Service Routines execute in response to the demands of external interfaces 
that the system does not itself control, such as intelligent peripheral (IP) 
communications and Mainframe Channel Interface (MCI) I/O completion. These requests 
execute in supervisor state, the higher of two privilege states of CPU operation. 

Interrupt Service Routines communicate with other code using intertask messages 
(ITMs). ITMs are specific in their form and content and are identified by number. They 
are sent to the normal or express queue of the destination task. 

The Executive uses firewalls to facilitate its error management for Interrupt Service 
Routines. Firewalls are special structures in execution stacks that allow code to return 
to a known checkpoint on demand. They are constructed within Interrupt Service 
Routines by means of supervisor calls that save the stack address, registers, and 
hardware status. By using firewalls, failures within Interrupt Service Routines are less 
serious; the system stack is recovered and the associated routine is notified of the 
error. 

Tasks 

System tasks perform the system's ordinary network layer and management functions. 
Tasks execute in the user state, the lower of two privilege states of CPU operation. 
Because task code responds in a less reactive fashion than Interrupt Service Routines, 
it may be dispatched and execute at different priority levels within the user state, 
depending on realtime response requirements. 

The Executive schedules task execution according to the task's priority level and 
preemptibility. 
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Each task has a unique User Stack for keeping track of variables, parameters, and 
registers during the chaining of calls required in its execution. The stack maintains 
information specific to the task to which it belongs. Unused stack length may be 
checked using the UNUSED_STACK_ function described in chapter 10. 

In addition to making direct calls for services, tasks may communicate with one 
another using ITMs. 

Parent Tasks 

Task recovery is enhanced by the concept of parent tasks, in which one task oversees 
the execution of another. A parent task oversees execution of its child task by servicing 
any ITMs from the Executive regarding Interrupt Service Routines and by executing 
recovery mechanisms in response to these messages. 

Task Control Block 

The Executive may redirect CPU processing from one task to another at any point 
during a task's execution. When this occurs, the context of the executing task must be 
saved until the Executive can schedule completion of that task. The Executive saves a 
task's context in a task control block (TCB). 

The TCB is addressed by its task_ptr (or taskid), which is created when the task is 
started. The TCB maintains the task state and includes, among other things: 

• Stack length and pointers 

• Parent/child task pointers 

• Task state and transition counters 

• Queue Control Blocks (QCBs) 

• Register save area 

• Task status register and program counter 

Refer to the data structures in appendix B of this manual for the CYBIL definition of 
the TCB structure. 

Message Queues 

Each task has both a normal and an express message queue. A separate QCB is 
maintained in the TCB for each of these queues. Messages sent to a task's normal 
message queue are generally concerned with intertask services. Messages sent to the 
express message queue are generally concerned with task error notifications. 

Each message queue is emptied in first-in, first-out (FIFO) order. The express queue 
takes priority; it is emptied first. 
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Task Attribute Flags 

Two attribute flags are associated with each task and maintained in the task's TCB. 
They are: 

Preemptible/Not Preemptible 

This flag indicates if the task may be preempted by the scheduling of higher 
priority tasks. If processing has begun on a task that is not preemptible, exception 
processing must return to that task even if higher priority work is subsequently 
scheduled (unless the task is aborted or an immediate control task is scheduled). 

If a preemptible task is preempted, the Executive reschedules that task's processing 
after the higher priority task completes. 

Immediate Control 

This flag overrides the preemptible/not preemptible flag. If a task is an immediate 
control task, then the Executive schedules its requests immediately, regardless of 
the preemptibility of the previously executing task. Only recovery tasks are 
immediate control tasks. 

NOTE 

This feature is not presently implemented. The immediate control flag will be 
passed, but it has no effect on task scheduling. 
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Task Management 

The Executive provides a flexible task management environment as one of its 
specialized services. Tasks may start, stop, or delay their own or another task's 
processing. They may also change their own priority, preemptibility, and state or those 
of other tasks. 

Besides passing work, tasks need to control access to shared resources (tables, for 
example). The standard method of controlling shared access is a semaphore that 
indicates whether a resource is in use. The Executive provides a semaphore service 
(SIGNAL(n)/ACQUIRE(n)). 

Following are brief descriptions of the Executive's task management procedures. 
Complete documentation of these procedures can be found in chapter 10 of this manual. 



Procedure 



Description 



ABORT_TASK 

DELAY_PROCESSING 

NEW_ INTERRUPT 

NEW_ PRIORITY 

NOPREMPT 

OKPREMPT 

RESTORE_TASK 

SIGNAL(n)/ACQUIRE(n) 

START_SYSTEM_TASK 

START_TASK 

STOP_TASK 

SUSPEND 

WAIT 

WAKE_UP 

YIELD 



Aborts the execution of a task 

Temporarily delays task processing 

Announces an interrupt service routine 

Changes a task's priority 

Supresses task preemption 

Restores task preemption 

Restores task from a suspended state 

Tests for, and sets, semaphores 

Starts a task with the system ancestor as its 
parent 

Starts task at procedure entry point 

Stops task execution 

Suspends task execution 

Puts task in a wait state 

Wakes a waiting task 

Yields control of the CPU 
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Memory Management 

The Executive manages the allocation of a configurable amount of system memory for 
use by tasks. During times of memory congestion, the Executive is still able to service 
critical memory requests by accessing other memory known to be free at the time of 
the request. This section describes some of the basic memory management concepts 
associated with these services. 

Data and Descriptor Buffers 

The Executive allocates memory efficiently by distinguishing between data and 
descriptor buffers (also referred to as long and short buffers, respectively). CYBIL 
definitions for buffers are given in appendix B of this manual. 

Data buffers hold user data. Associated with data buffers are descriptor buffers, which 
keep track of data buffer specifics such as chaining, usage counts, data offsets, data 
counts, and pointers. A configurable percentage of data and descriptor buffers is 
allocated for management by the Executive when the system is initialized. The 
relationship between descriptor and data buffers is illustrated in figure 3-1. 



Descriptor Buffer 



r 

M 

E i—i 



next descriptor 








Descriptor 
Buffer 












next message 




Data Buffer 






the data 




data usage 




Data 
Buffer 






offset 


data text 













Descriptor 
Buffer 










Data 
Buffer 









L *- next message 



Figure 3-1. Descriptor and Data Buffers 
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Buffer and Memory States 

Four states are defined to indicate the relative availability of buffers and memory in 
the DI. They are hierarchical in this order: good, fair, poor and congested. 

The boundaries between these states are set during configuration and may be changed 
using network operations commands. Each boundary is expressed as a percentage of the 
total resource currently available. For example, the boundary between fair and poor 
might be 20% of memory; if only 15% of memory is currently available, the memory 
state is said to be poor. 

Priorities and Thresholds 

The input parameter threshold indicates the priority level for data buffer and memory 
extent requests. Descriptor buffer requests do not require a priority; they are always 
accepted. 

Four data buffer request priorities are defined: 

Critical For requesting buffers for use in sending operator alarms and 
commands or completing any actions initiated to solve memory 
congestion problems. Critical requests are accepted in all buffer states. 

High For requesting buffers for use in receiving incoming data, sending a 

command response, or completing any error processing and recovery. 
High priority data buffers requests are accepted even if the buffer 
state is congested. 

Medium For requesting buffers for use in sending Routing protocol data units 
(PDUs) or error-related log messages. Medium priority data buffer 
requests are not accepted if the buffer state is congested. 

Low For requesting buffers for use in sending nonerror related log 

messages, such as statistics log messages. Low priority data buffer 
requests are not accepted if the buffer state is poor or congested. 

Only two memory extent request priorities are defined: 

Critical Critical requests are accepted in all memory states. 

Normal Normal memory extent requests are not accepted if memory state is 
congested. 
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Procedures and Functions 

Following are brief descriptions of the Executive's memory management procedures. 
Complete documentation of these procedures can be found in chapter 10 of this manual. 

Procedure Description 



CLEAR_ALLOCATE 

CLEAR_MEMORY 

CLE AR_ WRITE. PROTECT 

GET_ MEMORY 

GET_MPB_EXTENT 

GET_PMM_EXTENT 

MODIFY. WRITE_PROTECT_ 
BYTE 

MODIFY. WRITE_PROTECT_ 
LONG_WORD 

MODIFY. WRITE_PROTECT_ 
SHORT.WORD 

SET_BUFFER_CHAIN_OWNER 

SET_MEMORY_OWNER 

SET_WRITE_PROTECT 



Allocates space from free global memory and 
clears it 

Clears specified memory 

Clears write protect flag 

Gets global memory extents 

Gets MPB RAM memory extents 

Gets private memory extents 

Modifies write-protected MPB byte 

Modifies write-protected MPB long word 

Modifies write-protected MPB short word 

Sets owner identification for buffer chain 
Sets owner identification for memory location 
Sets the write protect flag 
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Message Management 

In addition to the memory management services just described, the Executive also 
provides routines that perform data manipulation of messages. Following are brief 
descriptions of these routines. Complete documentation of these procedures can be found 
in chapter 10 of this manual. 



Procedure 



Description 



APPEND 

ASSEMBLE 

BROADCAST 

BUILD_HEADER_IN_PLACE 

COPY 

FG_TRIM 

FIRST. BYTE _ ADDRESS 

FRAGMENT 

GEN_DATA_FIELD 

GEN_TEMPLATE_ID 
GET_DATA_ FIELD 

GET_FIRST_BYTE 

GET_LAST_BYTE 

GET_LONG_BUFFERS 

GET_ MESSAGE _ LENGTH 

GET_SHORT_BUFFERS 

GET_SIZE_N_ADDR 

M_RELEASE 

PCOPY 

PREFIX 

RELEASE_MESSAGE 
STRIP 



Appends a trailer to a message 

Assembles message fragments 

Prepares a message for broadcast 

Builds a message header 

Copies a message to another buffer chain 

Trims bytes from the end of message 

Returns message first byte address 

Extracts message fragment 

Generates a data field in Management Data 
Unit (MDU) format 

Builds template identifier fields into buffers 

Extracts data fields from MDU formatted 
message 

Returns first byte of message 

Returns last byte of message 

Gets one or more data buffers 

Returns byte length of message 

Gets one or more descriptor buffers 

Gets size and address of memory extent 

Decrements message usage count 

Copies message to new buffer chain, releasing 
old buffers 

Adds header to front of a message 

Releases data buffer chains 

Removes header from front of a message 
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Procedure Description 



STRIP_IN_PLACE Removes header from front of a message, 

without changing message address 

SUBFIELD Gets multiple-byte header fields 

TRANSLATE_MESSAGE Translates between character sets 

TRIM Trims bytes from end of descriptor buffer 
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Queue Management 

As described earlier, there are two QCBs maintained in each task's TCB. They are the 
Express Message QCB and the Normal Message QCB. These exist for the lifetime of 
the task. 

The Express Message QCB is used to inform a task of the successful or unsuccessful 
completion of a service request, or to notify it of some error condition it must service. 
The Express Message QCB is always inspected first. 

The Normal Message QCB is used for any other ITMs. It is inspected only after the 
express queue has been serviced. 

A QCB contains all the information needed to add new elements to the queue and to 
access and remove current queue elements. It holds a counter indicating the number of 
messages currently on the queue and a counter that tallies the total number of 
elements ever added to the queue. Each QCB contains pointers to both the first and 
last elements currently on the queue. 

Following are brief descriptions of the Executive's queue management procedures. 
Complete documentation of these procedures can be found in chapter 10 of this manual. 



Procedure 



Description 



GET_EXPRESS 
GET_MSG 

MESSAGE_DEQUEUE 
MESSAGE_ENQUEUE 
SEND_EXPRESS 
SEND_NORMAL 



Gets ITM from express queue 

Gets ITM from the express or normal queue (express queue 
first) 

Extracts a message from the specified task-level queue 

Places a message in the specified task-level queue 

Sends ITM to the express queue of the specified task 

Sends ITM to the normal queue of the specified task 
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Timer Management 

The Executive provides timer management services to its users. Included in these 
services are three ways for a task to request nonimmediate procedure execution: at a 
given time, after an interval, or periodically. If specified, parameters may be passed to 
the task at execution time in non-immediate requests. 

Following are brief descriptions of the Executive's timer management procedures. 
Complete documentation of these procedures can be found in chapter 10 of this manual. 



Procedure 



Description 



CALL_ AFTER. INTERVAL 

CALL_AT_TIME 

CALL_ PERIODIC 

CANCEL_TIMER 

CHANGE_TIMER_ OWNER 

DELAY_PROCESSING 

PMP_GET_DATE 

PMP_GET_TIME 

READ_BCD_CLOCK 

READ_CLOCK 

SET_BCD_CLOCK 

TIME 



Procedure is called after specified time interval 

Procedure is called at specified time 

Procedure is called periodically 

A previously requested timing request is cancelled 

Changes allocating task identifier for timing procedure 

Delays processing for a finite period of time 

Returns current date in specified format 

Returns current time in specified format 

Reads the real-time clock in BCD format 

Reads the binary clock to millisecond accuracy 

Sets the real-time clock 

Converts time intervals (including time-of-day) to 
milliseconds 
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Statistics Management 



Part of CDCNET's base system software provides for the collection and reporting of 
system statistics. In general, software components concerned with collecting statistics 
open Service Access Points (SAPs) to the CDCNET Statistics Manager (CSM). These 
SAPs point to a linked list of one or more statistics data structures (SDSs), which are 
used for the collection and reporting of statistics. The SDSs are specified by the 
software component when opening a statistics SAP. 

CSM acts as the bridge between commands that request statistics collection and the 
software that will actually collect the statistics. CSM sets a flag in the SDS that tells 
the collecting software component whether or not to collect statistics. The software 
component may ignore the flag and always collect statistics if more resources are 
required to check this flag than to collect the statistics. 

Two statistics buffers are supplied by the software component. While one is used for 
statistics collection, the other is being reported. 

Statistics SAP entries can be located using element type (network solution, 
communication line, or software component) and element names supplied by the 
command processors. Each SDS header is defined by a statistics group type. The 
statistics group types are: 

summary normal process statistics 

expanded statistics beyond normal processing 

debug statistics for debugging 

CSM manages statistics reporting by calling software component-supplied procedures 
that: 1) generate the log message containing collected statistics and 2) call the Log 
Support Application to issue the log message. CSM calls these procedures whenever 
statistics are to be reported. 

The services performed by CSM are summarized in figure 4-1. 

SAP Management 

Statistics SAPs can be opened and closed and SAP entries found. In general the 
SAP management service helps create a dynamic association between command 
processors and statistics collecting software components. 

Statistics Collection 

The CSM may enable or disable collection of statistics while specifying a collection 
interval. CSM users may issue commands to control the collection of statistics 
without having direct contact with the particular software components that do the 
collecting, or being aware of the associated data structures. 

Statistics Reporting 

Statistics are reported periodically according to time intervals specified by CSM 
commands. They are also reported when the corresponding statistics are started or 
stopped, or when the statistics SAP is closed. Report procedures supplied by the 
statistics collecting software components are called to generate and issue the log 
messages containing the statistics. 
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Statistics Management Relationships 

Figure 4-1 illustrates the central role that CSM plays in the management of CDCNET 
statistics. 
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Figure 4-1. CDCNET Statistics Manager 

Procedures and Functions 

Following are brief descriptions of the statistics management procedures and functions. 
Complete documentation of these procedures can be found in chapter 10 of this manual. 



Procedure 



Description 



OPEN_STATISTICS_SAP 
CLOSE. STATISTICS. SAP 



Opens a new statistics SAP 

Closes a previously opened statistics SAP 



FORCE .STATISTICS. REPORTING Forces call of the specified statistics function 

procedure 



BUILD.STATISTICS.MSG. 
HEADER 



Initializes statistics message header 



INITIALIZE.STATISTICS.RECORD Initializes MDU-formatted records used in 

statistics collection 
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Status Management 



This chapter describes CDCNET status management software. It identifies system 
device status tables, describes the various states and statuses of CDCNET hardware 
devices and the transitions between them, and discusses the storage and retrieval of 
state and status information. 

Hardware Device Status Tables 

Each CDCNET system contains the following device status tables. 

• Major Card Status Table (MCST) 

• Line Interface Module (LIM) Status Table (LST) 

• Port Status Table (PST) 

• SMM Bank Status Table (SBST) 

• PMM Bank Status Table (PBST) 

The MCST is a static table and contains an entry for each of the eight slots in a DI 
that are reserved for the major boards. Each entry contains information about the type 
of board installed, its state, status, and other relevant information. MCST entries of 
board type CIM contain a pointer to the LST. Similarly, entries for board types SMM 
and PMM contain pointers to the SBSTs and PBSTs, respectively. 

The LST is also a static table. It contains an entry for each of the eight slots reserved 
for the LIM boards. Each entry contains information about the type of LIM (for 
example, RS449), its state, status and a pointer to the PST. 

A separate PST exists for each LIM that is physically present in the DI. Each PST 
contains up to four entries for the ports on the associated LIM, and each entry 
contains information about the state and status of the associated port. 

Each SBST or PBST contains information about the state and status of the memory 
banks on the associated SMM or PMM board. 

All hardware device status tables are created by the Initial Loader prior to starting the 
System Ancestor as the initial task in the DI. The board map table created by the 
on-board diagnostics is used to determine which devices are physically present in the 
DI and identifies their initial states. For a formal description of the board map table, 
refer to the CDCNET Network Analysis Manual. 
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States and Statuses 

This section describes the possible values for the state and status of each of the 
hardware elements in a CDCNET system. It also describes how these values get 
updated and identifies the valid state transitions. 

State of a Hardware Device 

At any point in time, the state of a hardware device that is physically present in a 
CDCNET system can be ON, OFF or DOWN. 

The ON state implies that the device is either fully operational or operating in a 
degraded mode. The ON state further implies that the device is available for use by 
the system. 

The OFF state indicates that the device is not available to the system or diagnostics. 
A device may be placed in the OFF state to prohibit its further use. The logical 
equivalent of this state is that the device is not present in the system. 

The DOWN state indicates that a device is only available for use by the diagnostic 
software, and therefore is not available for normal system use. 

Initializing the State of Hardware Devices 

When a CDCNET system is loaded, the following process is used to initialize the state 
of hardware devices. 

The on-board diagnostics always build a table called the card map table. This table 
contains, among other things, the result of the execution of the on-board diagnostics on 
each device as well as the setting (ON or OFF) of the offline switch on each device. 
Status software uses this information to initialize the states of different devices. 

The state of a device is set to OFF if the offline switch is ON. If the offline switch is 
OFF and the on-board diagnostics have executed successfully on a device, its state is 
set to ON. If the offline switch is OFF and the on-board diagnostics have not run 
successfully on a device, then the device state is set to DOWN. 

Status of Hardware Devices 

A status will be associated with each device at all times. Following is the list of device 
status values. 

• not .configured 

• configured 

• enabled 

• active 
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Below is a table describing the processes and rules used to change the status of the 
main board devices. 

Board Type Status or Status Transition 



MPB 

SMM 

PMM 
ESCI 



MCI 



CIM 



Always configured. 

If ON, always configured. 

If OFF, then not _ configured. 

If ON, always configured. 

If DOWN or OFF, then not_configured. 

Initially, not_configured. 

After a trunk or interface is defined (using the DEFINE command), 
then configured. After an associated CANCEL command, then not_ 
configured. 

After successful ST ART_ TRUNK command, then active. After an 
associated STOP_TRUNK command, then configured. 

Initially, not _ configured . 

After a trunk or interface is defined (using the DEFINE command), 
then configured. After an associated CANCEL command, then not_ 
configured. 

After a START__TRUNK command, then enabled. 

If the channel interface is brought up successfully, then active; 
otherwise it remains enabled. 

The status of an MCI card will be changed from active or enabled to 
configured as a result of successful execution of an associated 
STOP_ TRUNK command. 

Initially, not _ configured. 

If any connected LIM is configured, then configured. 

After DEFINE_CIM_INTERFACE, then configured. 

NOTE 

The status of a CIM, ESCI, MCI, LIM or a port is active if it is in 
the DOWN state and is currently being tested by online diagnostics. 
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Status of LIMs and Ports 

After initialization, the status of any LIM or port is not _ configured. However, after a 
line or a trunk is defined for a port, the status of the port becomes configured. The 
status of a LIM changes to configured if any one of its ports has a configured status. 
The enabled status does not apply to LIMs. 

The status of a port is changed to not _ configured when the line or trunk defined to 
use it is cancelled. LIM status is changed from configured to not _ configured after 
all ports connected to it become not _ configured. 

Port status is changed from configured to enabled when the START command 
executes successfully. Status will change from enabled to active when the port's line 
or trunk becomes active. Port status is changed from active or enabled to configured 
when a STOP command is executed successfully. 

In the case of an HDLC or X.25 trunk, the term active indicates successful completion 
of the protocol handshake with the Layer 2 peer. In the case of an asynchronous line, 
the term active implies connection with a user of the line. 



State Transitions 

The following table indicates the possible state transitions and how they occur. 

From To Process 

ON OFF This state transition is made using an operator command called 

CHANGE_ELEMENT_STATE. It is allowed only if the element is 
not system critical and is not in active use. The MPB, SMM and 
PMM are system critical devices. An element is considered active if 
its status is enabled or active. 

ON DOWN The process and rules that apply to the transition from ON to OFF 

also apply to the transition from ON to DOWN. 

OFF ON This state transition is only made using an operator command. It is 

recommended that the state first be changed to DOWN, followed by 
an online diagnostics test to make sure that the device can be used 
by the system. 

OFF DOWN This state transition is only made using an operator command. 



DOWN OFF 



DOWN ON 



This state transition is only made using an operator command. It is 
not allowed if the device status is active. In the DOWN state, 
active status indicates that an online diagnostic test is being run on 
the device. 

This state transition is made using an operator command or by 
online diagnostics after successful testing. The operator command 
can make this transition while device status is not active. 
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Acquisition and Release of a Hardware Device 

The following routines are provided for request and release of hardware devices. 
Complete documentation of these procedures can be found in chapter 10 of this manual. 



Procedure 



Description 



GET_CARD_TYPE_AND_ 
ADDRESS 

RELEASE_HARDWARE_ DEVICE 



REQUEST_DIAGNOSTIC_ENTRY 



Gets the board type and address for the 
specified device 

Releases a previously configured hardware 
device 

Gets the address of the system status table 
entry for the specified device 



REQUEST_HARDWARE_DEVICE Configures the specified hardware device 



Accessing and Updating the Hardware Device Status 
Tables 

Any software component can copy entries from hardware device status tables using the 
procedure GET_ STATUS. RECORD. The owner of a hardware device can update or 
re-write an entry in the hardware device status tables using PUT_STATUS_RECORD. 

Following is a complete list and brief descriptions of the status management 
procedures. Complete documentation of these procedures can be found in chapter 10 of 
this manual. 



Procedure 



Description 



CLOSE_ STATUS_ SAP 
GET_NEXT_STATUS_SAP 

GET_ STATUS_ RECORD 
GET_ STATUS. SAP 

OPEN_STATUS_SAP 

PUT_STATUS_RECORD 



Closes previously opened status SAP 

Retrieves address of software component status 
table 

Retrieves status record for specified device 

Retrieves address of software component status 
table 

Registers the address of a software component 
status table 

Updates the status record for the named device 
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Tree (Table) Management 



Several of the layer and management entities in a DI logically connect a user and 
either a correspondent or a service using random access tables that are organized and 
accessed according to a balanced, binary tree solution. This solution provides relatively 
fast access to any table entry. And because new tables are allocated dynamically, 
memory is only used for tables allocated. 

To create a tree structure, the user must initialize the tree root. The root is a 
separate, user-created table that records the number of tables in the tree, validation 
information, and the address of the tree's first node. Tables are accessed by specifying 
a pointer to the root of the tree being referenced. 

A key is used to reference each tree node and its associated table. It is either a 32-bit 
integer or an adaptable string, depending on the type of tree structure created. Keys 
are used in tree searches. 

Following are brief descriptions of the tree management procedures. Complete 
documentation of these procedures can be found in chapter 10 of this manual. 



Procedure 



Description 



FIND 

FIND.FIRST 

FIND_FREE_NODE 
FIND_NEXT 

FIRST_NODE 

GROW 

INIT_ROOT 

PICK 

SFIND 

SFIND_FIRST 

SFIND_NEXT 

SFIND_WILD_CARDS 

SGROW 

SPICK 

VISIT_ALL_NODES 



Returns the table in a tree associated with the 
specified integer key 

Returns the first table and key that satisfy an 
input parameter 

Finds the first available node 

Returns the next table and key that satisfy an 
input parameter 

Allocates space for the first node of a tree 

Adds a new table to a tree 

Initializes the root of a tree 

Removes a structure from the specified tree 

Like FIND, for string keyed trees 

Like FIND_FIRST, for string keyed trees 

Like FIND_NEXT, for string keyed trees 

Locates wild card matches in a tree, for string 
keyed trees 

Like GROW, for string keyed trees 

Like PICK, for string keyed trees 

Steps through a tree structure, making 
successive calls to a user supplied routine for 
each node found 
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Online Loader 



The Online Loader provides a method for dynamic loading and deloading of software 
modules within an operational system. The Online Loader provides the following 
services, described separately below: 

• Module Loader 

• Module Deloader 

• Translation to Modules 

Module Loader 

The Module Loader service of the Online Loader loads modules by entry point name 
and module name. The load process consists of reading the object module file, 
allocating memory for the module sections, moving code and data into the sections, 
linking external references, and incrementing module use count. 

The Module Loader is a separate module in the standard system and may be present 
or absent independently of other system features. 

Module Deloader 

The Module Deloader service deloads unused modules. The deloading process consists of 
deallocating the memory used for the module sections and removing entry point names 
from the internal loader tables. 

The Online Loader's interlock feature prevents the deloading of modules while they are 
still in use. The module use count indicates the number of tasks or other processes 
that require a given module. Only when the module use count has gone to zero may 
the module be removed from the system. 

The Module Deloader is a separate module in the standard system and may be present 
or absent independently of other system features. 

Translation to Modules 

The Translation to Modules feature provides the entry point name and module name 
translation to already loaded modules or modules to be loaded. It also provides 
translations to support the checksum of all loaded modules, validate the program 
counter, and return transfer addresses. 
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Procedures and Functions 

Following are brief descriptions of the Online Loader interface procedures and 
functions. Complete documentation of these procedures can be found in chapter 10 of 
this manual. 



Procedure 



Description 



CHECKSUM_NEXT_MODULE 



Runs a checksum of the sections of the 
next module 



DECREMENT_MODULE_USE_COUNT 



Decrements the use count of a loaded 
module 



INCREMENT_MODULE _ USE .COUNT 



Increments the use count of a loaded 
module 



LOAD_ ABS_ MODULE _ AND_ DELAY 



LOAD_ABS_MODULE_AND_PROCEED 



Loads an absolute module (if not 
already loaded) while the caller waits 

Loads an absolute module (if not 
already loaded); the caller does not 
wait 



LOAD _ CMD _ PROCESSOR. AND _ DELAY 



Loads a command processor module (if 
not already loaded) while the caller 
waits 



LOAD_CMD_PROCESSOR_AND_ 
PROCEED 



Loads a command processor module (if 
not already loaded); the caller does not 
wait 



LOAD. ENTRY_ POINT_ AND_ DELAY 



LOAD_ENTRY_POINT_AND_PROCEED 



START_NAMED_TASK_AND_DELAY 



Loads the module associated with a 
given entry point (if not already 
loaded) while the caller waits 

Loads the module associated with a 
given entry point (if not already 
loaded); the caller does not wait 

Loads module associated with a given 
entry point (if not already loaded) and 
starts it as a task while the caller 
waits 



START_NAMED_TASK_AND_PROCEED 



Loads module associated with a given 
entry point (if not already loaded) and 
starts it as a task; the caller does not 
wait 



VALIDATE. SECTION. ADDRESS 



Translates a given address into a 
module name and section address 
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Failure Management 8 

This chapter describes the CDCNET hardware failure management philosophy and its 
present implementation. The present implementation is not a completed example of the 
more highly developed philosophy, but is straightforward and in accord with that 
philosophy. 

Hardware failures include the failures of the hardware elements in a DI and the media 
connected to a DI, as well as the failures caused by illegal use of the DI hardware by 
software (for example, use of an illegal instruction). 

The software that supports failure management in a CDCNET system is referred to 
collectively as the failure management software. This software has the following 
objectives. 

• It supports the detection and reporting of all hardware failures. The failure report 
identifies the field replaceable unit (FRU) or units responsible for the failure. 

• It provides a method of failure recovery. 

• It monitors the behavior of hardware elements and reports behavior that is out of 
the expected norm. 

This chapter continues with a description of failure management concepts, presents a 
general model of CDCNET failure management, covers the four failure management 
subsystems in a CDCNET system, and describes the logging of CDCNET failures. 

Failure Management Concepts 

Hard and Soft Errors 

Hardware failures can be classified as hard or soft. A failure is said to be hard if the 
damage done by it cannot be undone. One example of this is a read parity error. In 
this case, the information being read has been permanently corrupted. 

A failure is said to be soft if the damage done by it can be undone through a recovery 
process in hardware or software. One example of a soft failure is a single bit error, 
which is corrected automatically in hardware. Another example of a soft failure is a 
Cyclic Redundancy Check (CRC) error in an High-Level Data Link Control (HDLC) 
frame. This error is recovered from when software retransmits the HDLC frame. 

Unclassified Events and Failures 

CDCNET failure management software also reacts to certain events or failures that are 
not classified as hard or soft. Unclassified events include the warnings generated by 
hardware to inform software that the DI battery is getting weak or that the 
temperature in the DI is getting too high. 

Unclassified failures include abnormal operation of the data carrier and data set ready 
signals on a line connected to a LIM through a modem. Such failures can occur due to 
noise on the transmission line or during the normal disconnect sequence on some lines. 
These failures are similar to soft failures because one can correct for them by retrying 
the operation in which the failure is detected. These failures may also be ignored 
unless they reach a preset threshhold. 
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Failure Management Functions 

Failure management software has three important functions: detection, reporting, and 
recovery. 

Failure Detection 

Most failures are detected by hardware. If hardware detects a failure, it notifies 
software about it by writing the failure information into a status register and 
optionally generating an error interrupt (for example, a bus error interrupt). The 
CDCNET failure management software supports failure detection by providing the 
interrupt handlers to process the various error interrupts and by periodically 
monitoring the hardware status registers, a change in whose contents is not always 
accompanied by an interrupt. 

Failure Reporting 

Reporting of failures includes extracting the failure information from the hardware 
status registers and saving it in memory; it also includes notifying the software 
that executes on the failed element about the failure and logging the failure 
information in the CDCNET log file with a log message. 

If the failure causes a reset, however, then users of the failed element will not be 
notified of the failure. 

Failure Recovery 

In the recovery phase, CDCNET software determines whether the failed element can 
be used again and, if so, through what level of recovery. Necessary hardware and 
software is re-initialized and users of the failed element are notified of its renewed 
availability. 
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Structure of the Failure Management Software 

Hardware failures in a CDCNET system are managed on a subsystem basis. Each 
subsystem processes failures on one or more specific boards (for example, the MCI 
board) and the media connected to it. CDCNET failure management software defines 
four subsystems: MPB, CIM, ESCI and MCI. In addition to these subsystems, the 
failure management software includes some common code which is used by all 
subsystems. There is a general model for CDCNET failure management on which each 
subsystem is based. This general model is described below, followed by descriptions of 
the individual subsystems. 

General Model for Failure Management 

Figure 8-1 shows the model used as the basis for failure management in each 
subsystem. The generalized model requires the following functions to be present in each 
subsystem. 

• Fault handlers 

• A subsystem failure table 

• A subsystem failure management task 

In addition, this model requires a common service to maintain statistics about different 
failures and recoveries. 
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Figure 8-1. General Failure Management Model 
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MPB Subsystem 

The MPB subsystem manages failures on the MPB, SMM and PMM boards. It is also 
responsible for the management of failures caused by illegal use of hardware by 
software executing on the MPB board. In addition, it processes environmental warnings 
such as high temperature and low AC (power) warnings. 

MPB software components are expected (but not required) to provide a recovery 
procedure to be invoked if a failure is detected while the software component is 
executing. The System Ancestor will invoke a default failure recovery procedure where 
necessary if one is not provided. 

The following software components provide the failure management functions in the 
MPB subsystem. 

MPB bus error handler 
SMM error interrupt handler 
MPB spurious interrupt handler 
MPB level seven interrupt handler 
68000 address error handler 
68000 exception handler 
System Ancestor 
System Audit 
Executive Error Table 

Figure 8-2 shows the different software components in the MPB failure management 
subsystem and their relationships with each other and with the common failure 
management software. 
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Figure 8-2. MPB Subsystem Failure Management Model 
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CIM Subsystem 

The CIM subsystem manages failures on the CIM and LIM boards as well as on the 
LIM ports and the communication lines connected to the LIMs. It is also responsible 
for the management of failures caused by illegal use of hardware by software executing 
on the CIM board. 

The following software components provide the failure management functions in the 
CIM subsystem. 

CIM bus error handler 

CIM spurious interrupt handler 

CIM 68000 address error handler 

CIM 68000 exception handler 

CIM monitor 

CIM modem signal monitor 

DVM interrupt routines 

DVM task 

CIM failure table 

Figure 8-3 shows the different software components in the CIM failure management 
subsystem and their relationships with each other and with the common failure 
management software. 
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ESCI Subsystem 

The ESCI subsystem manages failures on the ESCI board and any failures of the 
tranceiver connected to the Ethernet. It also manages failures caused by illegal use of 
hardware by software executing on the ESCI board. Failure management in the ESCI 
subsystem is identical to failure management in the CIM subsystem, except in two 
regards. 

The ESCI subsystem includes one additional exception handler called the ESCI M68000 
Level Six Interrupt Handler. The reason for this is that the ESCI board has two 
processors; namely, the M68000 and the Ethernet controller. Only one of these 
processors can access the internal system bus (ISB) at any point in time. The failures 
that are normally reported by the bus error are reported by the ESCI bus error 
interrupt if the ISB was being accessed by the M68000 on the ESCI board. On the 
other hand, these failures are reported by the Level Six Interrupt Handler on the 
M68000 processor if they occur while the ethernet controller was accessing the ISB. 
Functionally, the ESCI bus error handler and the Level Six Interrupt Handler are 
identical. 

The second difference between the CIM and ESCI subsystems is that unlike CIM there 
is only one user of the ESCI; namely, the ESCI SSR. It is important to note that DVM 
serves as the failure management task for CIM and ESCI by performing a significant 
number of failure management functions for these subsystems. DVM does not 
differentiate between CIM and ESCI in any way. 

The following software components provide the failure management functions in the 
ESCI subsystem. 

ESCI bus error handler 

ESCI 68000 level six interrupt handler 

ESCI spurious interrupt handler 

ESCI 68000 address error handler 

ESCI 68000 exception handler 

ESCI firmware 

DVM interrupt processor 

DVM failure management task 
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Structure of the Failure Management Software 



ESCI failure table 

Figure 8-4 shows the different software components in the ESCI subsystem and their 
relationships with each other and with the common failure management software. 
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Figure 8-4. ESCI Subsystem Failure Management Model 



Revision A 



Failure Management 8-7 



Structure of the Failure Management Software 



MCI Subsystem 

The MCI subsystem manages failures on the MCI board and the channel interface 
connected to it. 

The following software components provide the failure management functions in the 
MCI sybsystem. 

MCI driver error interrupt handler 
MCI SSR 

Figure 8-5 shows the different software components in the MCI subsystem and their 
relationships with each other and with the common failure management software. 
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Figure 8-5. MCI Subsystem Failure Management Model 
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Logging of Failure Information 

It is important that all failure information be logged. However, there are two 
important considerations in defining a process to log failure information. 

The first concern is about the ability of CDCNET software to generate and transmit a 
log message after having encountered a failure. The failure may have corrupted key 
data structures or program space, thus inhibiting the logging process. The second 
concern is about generating too many log messages. For example, certain failures are 
expected to occur and it does not make sense to log each occurrence of such failures. 

Unfortunately, hard failures-which generally need to be logged-can potentially inhibit 
their own logging. On the other hand, soft failures can generally be logged, but don't 
always need to be. The following two sections address the logging of hard and soft 
failures and describes how CDCNET software takes care of the two concerns just 
mentioned. 

Logging of Hard Failures 

CDCNET software attempts to log each occurrence of a hard failure. If failure recovery 
does not require resetting the DI, the appropriate subsystem failure management task 
generates a log message to report the failure. This log message identifies the specific 
failure and includes all relevant failure information, such as the contents of the 
corresponding hardware status registers. 

If failure recovery requires resetting the DI, no attempt is made to generate a log 
message prior to reset. In this case the failure information is saved both in the 
subsystem failure table and the system failure table. Then, if the system is successfully 
reloaded and restarted, both the system and subsystem initialization software extract 
the failure information from the failure tables and report it with a log message. 

The key to this process is that the subsystem failure tables not get destroyed during 
the DI reload. These tables, with the exception of the Executive (MPB) Error Table, 
are not protected in a power-on reset and so are initialized to a clear state. 

It is also important that the failure information in the subsystem failure tables not be 
written over until it has been logged. 

WARNING 

One implication of this is that if a second failure occurs before information about the 
first failure has been logged, then the information about the second failure is not saved 
and may never get logged. 
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Logging of Soft Failures 

The concern with soft failures is to control the number of times they get logged. This 
is done by defining a threshold for each soft failure and logging the failure only if this 
threshold is exceeded. CDCNET failure management software defines two logging 
thresholds, absolute and timed. 

If an absolute threshold is used, all occurrences of a failure are counted and a log 
message is generated when the total count of failures exceeds a fixed number. This 
fixed number is known as the absolute threshold. The count of failures is initialized to 
zero every time a log message is generated to report the failure. 

If a timed threshold is used, the number of failures over a fixed interval is counted. If 
this count exceeds a specified number within the specified interval, the failure is 
logged. In this case, the number of failures, together with the fixed time interval, 
define the timed threshold. 



8-10 Base System Software Revision A 



The Device Manager (DVM) 9 

Device Control Services 9_1 

Status Request Services 9_1 

Data Transfer Services 9_2 

Diagnostic Services g_2 

DVM Order of Events 9.3 

DVM Major Data Structures 9.4 

Device Control Block (DVCB) 9-4 

Device Identifier (DVMID) 9-6 

DVM Command Packets and Status ITMs 9.7 



The Device Manager (DVM) 



9 



The Device Manager (DVM) is a set of routines responsible for the interface between 
CDNA's physical and link layers (layers 1 and 2, respectively). By controlling access to 
the "intelligent" peripheral boards (IPs), the DVM provides its users with a single, 
common mechanism for reaching the physical I/O layer, and ensures that no two users 
will be assigned to the same port. DVM's users include stream service routines (SSRs) 
and TIPs. 

This chapter describes each of the general services provided by the DVM, details the 
order of events in its operation, and describes its major data structures. Each of the 
DVM procedures mentioned here is fully documented in chapter 10 of this manual. 

Device Control Services 

These services coordinate the allocation, initialization, and release of control blocks for 
IPs and their individual ports. They also control the loading of controlware to the 
boards. Device control procedures are: 



Procedure 



Description 



START_ DEVICE_ SERVICE 
STOP_ DEVICE _ SERVICE 
START_PORT_ SERVICE 
STOP_ PORT. SERVICE 
RESTART_PORT_SERVICE 
CHANGE_DVM_TASK_ID 



Starts DVM services for the specified device 

Stops execution of a peripheral device service 

Establishes service for a specific port 

Stops service for a given port 

Restarts service for a specific port 

Changes ownership of a specific port to a new 
task 



Status Request Services 

These services provide the status of specific hardware to the user. Status request 
procedures are: 



Procedure 



GET_CIM_NUMBER 

DEVICE_ STARTED 

DUMP_IP_MEMORY 
GET_ CIM _ BOOT_ SOURCE 



Description 



Determines a CIM slot number from the 
user-supplied LIM and PORT number 

Determines whether or not the peripheral board 
has been started 

Dumps the peripheral board's local RAM 

Returns the LIM and port number over which 
the DI was booted 
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Data Transfer Services 

Data transfer services provide DVM users a means of passing commands to the 
intelligent peripheral boards. The procedure is called QUEUE_IP_COMMAND. 

Diagnostic Services 

These services allow MPB-resident diagnostic code to alter the peripheral board 
environment and to run on-line diagnostic tests. Diagnostic code can also return the 
peripheral board to its previous environment. 

DVM's diagnostic services procedures are: 

Procedure Description 



SEND_CR0_TO_IP 

READ_SR0_FROM_IP 

QUEUE_IP_COMMAND 

CHKSUM_IP_COMMAND_ 
PACKET 

CHANGE_DVM_INTERRUPT 
RESTORE_DVM_INTERRUPT 

NOTE 



Sends command register to an IP 

Reads status register from an IP 

Queues a command to an IP 

Performs a checksum operation on a restart 
packet to be sent to an IP 

Changes the interrupt procedure used to handle 
interrupts from an IP 

Restores the original interrupt routine used 
before the CHANGE. DVM .INTERRUPT 
procedure executed 



DVM diagnostic services procedures are not intended for general use. 
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DVM Order of Events 

DVM users can make direct calls to DVM that will execute from within the caller's 
stack and under control of the caller's task. DVM queues commands to the IP for 
processing and supplies information to its users by an ITM. These ITMs are 
asynchronous with respect to calls made by the user to DVM. The process is illustrated 
in figure 9-1 and described below. 

• DVM communicates with a peripheral board using a commonly referenced area of 
SMM memory, the Device Control Block (DVCB). The DVCB is allocated by DVM 
and its address is made known to the IP as part of the peripheral board load 
process. When a user issues a command to an IP through DVM, the command 
packet is sent to the command queue area of the DVCB. It is up to the peripheral 
board, then, to check the DVCB to determine if there are any outstanding 
commands to be processed. 

• When the peripheral board completes processing of the command, it will build a 
response and enqueue that response to the status queue area of the DVCB. Then 
the peripheral board issues an interrupt to the DVM. DVM will process the status 
queue and return the appropriate status to the caller using an ITM. 

• If the IP receives data from an active port, it will package that data into a status 
packet and enqueue the packet to the status area of the DVCB. The IP will then 
issue an interrupt to the DVM. DVM processes this status packet by building an 
ITM and routing it to the appropriate user. 
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Figure 9-1. DVM Relationships 
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DVM Major Data Structures 



Device Control Block (DVCB) 

The DVCB is a data structure that retains information about an interface's IPs. Each 
peripheral has its own DVCB in SMM. DVM uses DVCBs to control access between 
tasks residing on the MPB and tasks residing on the peripheral boards. 

The structure of the DVCB is illustrated in figure 9-2. 
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Figure 9-2. Device Control Block 
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The DVCB contains: 

• The addresses of the mapped control and status registers of the associated 
peripheral. 

• A pair of addresses of empty buffer chains to be used by the peripheral as needed 
to receive data. 

• A set of addresses and indexes that control the sequences of status and command 
queues. 

• The address of the first device identifier (referred to as DVMID) that may be 
assigned to the DVCB. 

The DVM maintains an array of DVCB addresses to access the peripherals. 
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Device Identifier (DVMID) 



The DVID structure contains information about a specific port controlled by the IP and 
also information required by DVM to communicate with the corresponding TIP or SSR. 

The structure of a DVID is illustrated in figure 9-3. 
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Figure 9-3. Device Identifier 



The DVID contains: 



The TASKID of the user to which all status responses are to be routed for this 
port. 

Address of the owning DVCB. 

A mask specifying which status responses are to be routed using the express 
message queue and which are to be routed using the normal message queue. 

The physical LIM and PORT numbers assigned to this DVMID (for CIM only). 

The address of the next DVID linked to the DVCB. 
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DVM Command Packets and Status ITMs 

DVM uses two circular queues to support interfaces to the IPs. The command queue is 
used to pass information from the DVM user to the IP. The status queue is used to 
pass status packets from the IP back to the DVM user. The IP interrupts the MPB to 
inform DVM that a status packet should be returned to the DVM user. 

Command packets are passed from DVM users to the IPs through the DVM QUEUE _ 
IP_COMMAND procedure. The IPs use DVM services to return status packets to their 
users; these are in the form of ITMs. The formats of the command packets and the 
status ITMs for CIM and ESCI are defined in appendix B. 
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This chapter documents the common routines provided by CDCNET's base system 
software. These procedures and functions may be called on to perform the basic 
services described in the early chapters of this manual. 

Conventions 

Descriptions of the procedures and functions adhere to the following conventions: 

• The procedure or function name appears at the top of the page in full capital 
letters. 

• A short description of the purpose of the procedure or function follows. This tells 
you how the procedure is used, not how it is processed. 

• The name of the common deck (comdeck) where the XREF procedure is to be found 
is given next. This must be specified in the procedure's deck reference, as in the 
following example (using comdeck CMXSISA): 

(*callc CMXSISA) 

• The format of the call to the procedure is given, including any formal parameters. 

• Input parameters are described. 

• Output parameters are described. 

• Finally, any special remarks concerning the procedure or function are made, 
including cautions or warnings. 
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Logical Groups 



For easy reference, the procedures and functions have been grouped below by software 
component. 

DI Debugger Interface 

DI_DEBUG 
DI_DEBUG_INIT 

DVM Interface 

CHANGE _ DVM_ INTERRUPT 

CHANGE_DVM_TASK_ID 

CHKSUM_IP_COMMAND_PACKET 

DEVICE_STARTED 

DUMP_IP_MEMORY 

GET_CIM_BOOT_SOURCE 

GET_CIM_NUMBER 

QUEUE_IP_COMMAND 

READ_SR0_FROM_IP 

RESTART_PORT_SERVICE 

RESTORE. DVM_INTERRUPT 

SEND_CR0_TO_IP 

START_ DEVICE _ SERVICE 

START_PORT_SERVICE 

STOP_DEVICE_SERVICE 

STOP_PORT_SERVICE 

General Purpose 

ABORT_SYSTEM 

ABS, MAX, MIN 

CONVERT_INTEGER_TO_POINTER 

CONVERT_POINTER_TO_INTEGER 

DEAD_STOP 

FIELD_SIZE 

I_COMPARE 

I_COMPARE_COLLATED 

I_SCAN 

I_TRANSLATE 

MDU_TO_ASCII 

NAME_MATCH 

UNUSED. STACK. 
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Hardware Device Interfaces 

GET_CARD_TYPE_AND_ADDRESS 
RELEASE_HARDWARE_DEVICE 
REQUEST_DIAGNOSTIC_ENTRY 
REQUEST_HARDWARE_DEVICE 

Memory Interfaces 

CLEAR_ALLOCATE 

CLEAR_ MEMORY 

CLEAR. WRITE.PROTECT 

GET_ MEMORY 

GET_MPB_EXTENT 

GET_PMM_EXTENT 

MODIFY. WRITE_PROTECT_BYTE 

MODIFY. WRITE _ PROTECT. LONG. WORD 

MODIFY. WRITE.PROTECT.SHORT.WORD 

SET. BUFFER. CHAIN. OWNER 

SET.MEMORY.OWNER 

SET.WRITE.PROTECT 

Message Management 

APPEND 

ASSEMBLE 

BROADCAST 

BUILD_HEADER_IN_PLACE 

COPY 

FG.TRIM 

FIRST.BYTE.ADDRESS 

FRAGMENT 

GEN.DATA.FIELD 

GEN.TEMPLATE.ID 

GET.DATA.FIELD 

GET.FIRST.BYTE 

GET.LAST.BYTE 

GET.LONG.BUFFERS 

GET.MESSAGE. LENGTH 

GET.SHORT.BUFFERS 

GET.SIZE.N.ADDR 

MESSAGE.DEQUEUE 

MESSAGE.ENQUEUE 

M.RELEASE 

PCOPY 

PREFIX 

RELEASE.MESSAGE 

STRIP 

STRIP.IN.PLACE 

SUBFIELD 

TRANSLATE.MESSAGE 

TRIM 
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Logical Groups 

Online Loader Interface 

CHECKSUM_NEXT_MODULE 

DECREMENT_MODULE_USE_COUNT 

INCREMENT_MODULE_USE_COUNT 

LOAD_ABS_MODULE_AND_DELAY 

LOAD_ABS_MODULE_AND_PROCEED 

LOAD_CMD_PROCESSOR_AND_DELAY 

LOAD_CMD_PROCESSOR_AND_PROCEED 

LOAD_ENTRY_POINT_AND_DELAY 

LOAD_ENTRY_POINT_AND_PROCEED 

START_NAMED_TASK_AND_DELAY 

START_NAMED_TASK_AND_PROCEED 

VALIDATE_SECTION_ADDRESS 

Queue Management 

MESSAGE_DEQUEUE 
MESSAGE_ENQUEUE 

Statistics Management 

OPEN_STATISTICS_SAP 

CLOSE_STATISTICS_SAP 

FORCE_STATISTICS_REPORTING 

BUILD_STATISTICS_MSG_HEADER 

INITIALIZE_STATISTICS_RECORD 

Status Management 

CLOSE_STATUS_SAP 
GET_ NEXT. STATUS. SAP 
GET_STATUS_RECORD 
GET_ STATUS. SAP 
OPEN.STATUS.SAP 
PUT.STATUS.RECORD 

System Ancestor Interface 

DUMP.CLOSE 

DUMP.WRITE 

RESET. DI 

RESET.RECOVERY.PROCEDURE 

SET.RECOVERY.PROCEDURE 

START. DUMP 

START.SYSTEM.TASK 
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Logical Groups 



Task Management 

ABORT_TASK 

DELAY_PROCESSING 

GET_ EXPRESS 

GET_MSG 

MAYBE_TASK 

NEW_INTERRUPT 

NEW_PRIORITY 

NOPREMPT 

OKPREMPT 

RESTORE_TASK 

SEND_EXPRESS 

SEND_ NORMAL 

SIGNAL(n)/ACQUIRE(n) 

START_TASK 

STOP_TASK 

SUSPEND 

WAIT 

WAKE_UP 

YIELD 

Timer Services 

CALL_AFTER_INTERVAL 

CALL_AT_TIME 

CALL_ PERIODIC 

CANCEL_TIMER 

CHANGE_TIMER_OWNER 

PMP_GET_DATE 

PMP_GET_TIME 

READ_BCD_CLOCK 

READ_CLOCK 

SET_BCD_CLOCK 

TIME 

Tree (Table) Management 

FIND 

FIND_FIRST 

FIND_FREE_NODE 

FIND_NEXT 

FIRST_NODE 

GROW 

INIT_ROOT 

PICK 

SFIND 

SFIND_FIRST 

SFIND_NEXT 

SFIND_WILD_CARDS 

SGROW 

SPICK 

VISIT_ALL_NODES 

Base system software procedures and functions are described in alphabetical order on 
the remaining pages of this chapter. 
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ABORT SYSTEM 



ABORT _ SYSTEM 

This procedure brings the system to a halt and displays the specified message text at 
the MPB-connected terminal (if present). 

Comdeck CSXABRT 

Format ABORT .SYSTEM (halt_code, message_ptr) 

input halt _ code: integer 

This parameter indicates what brought the system down. If halt_code is a 
valid reset (see common deck SIDRC), then a call is made to RESET_DI. 
Otherwise, a call is made to DEAD_STOP, where a default halt_code is 
used. 

message _ptr: * string (* <= dbc$single_line) 

This parameter is a pointer to an adaptable string containing message text 
about why the abort was necessary. 

Output None. 
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ABORT __TASK 

This procedure signals that a task is undergoing a software failure, and that recovery 
is required. The indicated task is checked to see if it has a parent task. If it does not, 
it is stopped with STOP_TASK and the entire system is brought to a halt. If the 
indicated task does have a parent task, the task is suspended and the parent task is 
notified with an ITM. 

ABORT_TASK is intended to be a response to an illogical software condition, invoking 
action from the parent to recover or restart the aborted task. 

Comdeck CMXMTSK 

Format ABORT_TASK (abort_code, task_id, status) 

input abort _ code: integer 

This parameter indicates the reason the caller wants the task aborted. 

task_id: task_ptr 

This parameter indicates the address of the task to be aborted. 

Output status: boolean 

This parameter indicates whether or not the task was aborted. 
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ABS, MAX, MIN 

These numeric functions are quite predictable. They perform the following operations: 
ABS Returns the absolute value of an integer. 

Returns the greater of two integer values. 
Returns the lesser of two integer values. 
CMXPMMA 



MAX 
MIN 

Comdeck 

Format 



value: = ABS (a) 
value: = MAX (a, b) 
value: = MIN (a, b) 

input a: integer 

This parameter may be any integer value. 

b: integer 

This parameter may be any integer value. 

Output value: integer 

This parameter returns the result of the numeric operation being 
performed. 
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APPEND 

This procedure appends a trailer to a message. The message is checked for use by 
multiple data streams. If any portion is multiply used, that portion is logically copied. 

Comdeck CMXPAPP 

Format APPEND (size_of_ trailer, addr_ of _ trailer, message .pointer, 

threshold, allocation _ type, result, status) 

input size _ of .trailer: non_ empty .message, size 

This parameter indicates the length of the trailer in bytes. The allowable 
range is 1 through 65535 bytes. 

addr. of. trailer: "cell 

This parameter indicates the address of the trailer. 

message .pointer: buf.ptr 

This parameter indicates the address of the message to which the trailer 
will be appended. 

threshold: threshold .size 

This parameter indicates the threshold for buffer acquisition. 

allocation. type: pref.type 

This parameter indicates how the call is to be performed. See the 
description of pref_type (under BUFFER in appendix B) for options. 

Output message .pointer: buf.ptr 

This parameter returns the address of the message to which the trailer has 
been appended. This is different from input only if a new data buffer must 
be allocated to contain a longer message. 

result .status: boolean 

This parameter indicates whether or not the trailer was appended to the 
message. 

Remarks In case of a logical copy operation, the message_pointer returned may be 
different than the message_ pointer supplied. 
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ASSEMBLE 

This procedure assembles two message fragments into a single message by attaching 
the second fragment to the end of the first. 

Comdeck CMXPASS 

Format ASSEMBLE (fragment. 1, fragment_2, threshold) 

input fragment _1: buf_ptr 

This parameter indicates the address of the first message fragment. 

fragment _ 2: buf_ptr 

This parameter indicates the address of the second message fragment. 

threshold: threshold _ size 

This parameter indicates the threshold for buffer acquisition. 

Output fragment _1: buf_ptr 

This parameter returns the address of the first fragment, which contains 
the assembled message on output. If any of fragment— 1 is multiply used, 
the portion so used is logically copied and the output parameter will differ 
from input. 
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BROADCAST 

This procedure prepares a message for multiple use. This is accomplished by updating 
the user count of the first descriptor of the message to show the increased number of 
data streams that must logically release the message before it may be physically 
released. 

Comdeck CMIPBRO 

Format BROADCAST (message, number _of_ new _ data _ streams) 

input message: buf_ptr 

This parameter indicates the address of the message to be broadcast. 

number _of_ new _ data .streams: 1 .. 32767 

This parameter indicates the number of data streams to be added to the 
user count of the message being prepared for broadcast. 

This parameter value is incremented by 1 when the user wants to keep a 
copy of the message. The call to BROADCAST is often made with the 
count equal to one since BROADCAST simply adds to the logical number 
of copies of a message already in place. 

Output None. 
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BUILD _HEADER_IN_PLACE 

This procedure gets a buffer or descriptor as needed, creates space in the message to 
hold the specified header, and returns both the new message address and the address 
of the header structure. The current first buffer is used if the header will fit and starts 
on an even byte. 

Comdeck CMXPBLD 

Format BUILD _ HEADER. IN _PLACE (length, addr, message, threshold, 

allocation _ type, success) 

input length: non_ empty _ buffer 

This parameter indicates the number of bytes reserved for the header. 
Allowable range is 1 .. 1024. 

addr: *cell 

This parameter indicates the pointer to the address of the header. 

message: buf_ptr 

This parameter indicates the address of a pointer to the message. 

threshold: threshold _ size 

This parameter indicates the buffer allocation threshold. 

allocation _ type: pref_type 

This parameter indicates how the call is to be performed. See the 
description of pref_type (under BUFFER in appendix B) for options. 

Output addr: "cell 

This parameter returns the pointer to the address of the header. This will 
differ from input only if a new buffer has been allocated. A new buffer is 
allocated if the header does not fit into the original buffer. 

message: buf_ptr 

This parameter returns the address of a pointer to the message. This will 
differ from input only if a new buffer has been allocated. A new buffer is 
allocated if the new message will not fit into the original buffer. 

success: boolean 

This parameter indicates whether or not the operation was successful. 

Remarks The size of a header that is allocated may not exceed the size of the data 
space of a data buffer; larger headers must be generated using PREFIX. 
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BUILD .STATISTICS _MSG _HDR 

This procedure initializes and puts TIME and REASON fields into a log message. 
Comdeck SMXSAPM 

Format BUILD_STATISTICS_MSG_HDR (sds_header_ptr, time, reason, 

statistics _log_ msg) 

input sds_ header _ptr: ~sds_header 

This parameter indicates the pointer to a chain of one or more sds_ 
headers. 

time: report_time_type 

This parameter indicates the TIME field to be used in the header being 
built. 

reason: statistics _ reason _ type 

This parameter indicates the REASON field to be used in the header being 
built. 

Output statistics. log _ msg: buf_ptr 

This parameter returns the address of the generated statistics log message. 
If NIL, invalid calling parameters were specified. 
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CALL_ AFTER .INTERVAL, FG .AFTER .INTERVAL 

An ITM is enqueued to the timer task requesting the execution of a subroutine after a 
specified time interval has elapsed. These calls have the following effects: 



CALL_AFTER_INTERVAL 
FG_AFTER_INTERVAL 



Comdeck 
Format 



Input 



Output 



Enqueues timer request. 

For interrupt routines only; enqueues timer 
request. 



CMXMTIM 



CALL _AFTER_ INTERVAL (interval, parameter, timer .routine, 
timer _ request ..identifier) 

FG_AFTER_INTERVAL (interval, parameter, timer .routine, timer_ 
request _ identifier) 

interval: milliseconds 

This parameter indicates the number of milliseconds in the interval before 
the subroutine is executed. Milliseconds can be calculated by calling the 
TIME procedure. 

parameter: "cell 

This parameter indicates the address of the user-defined parameters for the 
procedure to be executed. 

timer .routine: "procedure (parameter: "cell) 

This parameter indicates the subroutine to be executed. 

timer_request_identifier: "timer 

This parameter returns the timer entry address if the procedure executed 
successfully. 
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CALL_AT_TIME, FG_AT_TIME 

An ITM is enqueued to the timer task requesting the execution of a subroutine at a 
given time. These calls have the following effects: 



CALL_AT_TIME 
FG_AT_TIME 



Comdeck 
Format 



Input 



Output 



Remarks 



Enqueues timer request. 

For interrupt routines only; enqueues timer 
request. 



CMXMTIM 



CALL_AT_TIME (time _ of _ day, parameter, timer _ routine, timer, 
request _ identifier) 

FG_AT_TIME (time_of_day, parameter, timer _ routine, timer_ 
request _ identifier) 

time _ of _ day: milliseconds 

This parameter indicates the execution time in milliseconds, with midnight 
equal to zero. 

parameter: 'cell 

This parameter indicates the address of the user-defined parameters for the 
procedure to be executed. 

timer _ routine: "procedure (parameter: "cell) 

This parameter indicates the subroutine to be executed. 

timer _request_identifier: "timer 

This parameter returns the timer entry address if the procedure executed 
successfully. 

If the requested time has passed (for example, it is now 12:05 a.m. and an 
execution time of midnight is requested), the request is understood to 
expire on the next day. See also: CANCEL_TIMER Request. 
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CALL_PERIODIC, FG_PERIODIC 

An ITM is enqueued to the timer task requesting periodic activation of a subroutine 
until the request is cancelled or until the requesting taskid is no longer valid. Requests 
from interrupt routines must actually be cancelled. 



These calls have the following effects: 



CALL_PERIODIC 
FG.PERIODIC 



Comdeck 
Format 



Input 



Output 



Remarks 



Enqueues timer request. 

For interrupt routines only; enqueues timer 
request. 



CMXMTIM 



CALL _ PERIODIC (first _ expiration, interval, parameter, timer _ 
routine, timer_request_identifier) 

FG_PERIODIC (first _ expiration, interval, parameter, timer _ routine, 
timer _request_identifier) 

first _ expiration: milliseconds 

This parameter indicates the starting time in milliseconds for the first call 
to be made. A value of NIL implies the current time. 

interval: milliseconds 

This parameter indicates the number of milliseconds in the interval 
between subroutine executions. 

parameter: 'cell 

This parameter indicates the address of the user-defined parameters for the 
procedure to be executed. 

timer _ routine: "procedure (parameter: "cell) 

This parameter indicates the subroutine to be executed. 

timer_request_identifier: "timer 

This parameter returns the timer entry- address if the procedure executed 
successfully. 

If the requested time has passed (for example, it is now 12:05 a.m. and an 
execution time of midnight is requested), the request is understood to 
expire on the next day. See also: CANCEL_TIMER request. 
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CANCEL_TIMER, FG_ CANCEL _TIMER 

A previously requested timing function (CALL_AFTER_INTERVAL, CALL_AT_TIME 
or CALL_ PERIODIC) is cancelled. These calls have the following effects: 



CANCEL_TTMER 
FG_CANCEL_TIMER 



Comdeck 
Format 

Input 



Output 



Timer request is cancelled. 

For interrupt routines only; timer request is 
cancelled. 



CMXMTIM 



CANCEL. TIMER (timer _id, parameter, status) 
FG_CANCEL_TIMER (timer _id, parameter, status) 

timer _ id: "timer 

This parameter indicates the timer entry associated with the timing 
procedure to be cancelled. The timer_id must be the value returned by the 
timing function call. If an invalid value is specified, the DI will be reset. If 
NIL, FALSE will be returned in status. 

timer _ id: NIL 

The timer_id is returned as NIL so that it will not be used again. 

parameter: "cell 

This parameter returns the address of the user-defined parameters for the 
procedure whose timing function is being cancelled. 

status: boolean 

This parameter indicates whether or not the timer was cancelled 
successfully. 
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CHANGE _DVM .INTERRUPT 

DVM Diagnostic Services use this procedure to change the interrupt procedure used to 
handle interrupts from a peripheral. 

Comdeck DMXDIAG 

Format CHANGE. DVM .INTERRUPT (new.proc, ip .number, owner, status) 

Input new.proc 

This parameter indicates the address of the new interrupt procedure. 

ip.numben 0..upper_ip_num 

This parameter indicates the slot number of the IP. 

Output owner: task.ptr 

This parameter returns the address of the original DVM user. 

status: 0..0ffff(16) 

This parameter returns the status of CHANGE_DVM_INTERRUPT. The 
status codes are: 

0: command accepted 

1: invalid IP slot number 

2: IP board is active 

4: bus error received on ICB access 
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CHANGE _DVM _t ASK _ID 

This procedure is used to change the ownership of a specific port to that of a new task 
by giving control of the specified DVMID to a new DVM user. 

Comdeck DMXXPS 

Format CHANGE _ DVM _ TASK _ ID (dvm_id, new_task_id, status) 

input dvm_id: "cell 

This parameter indicates the address of the specified port control block 
(DVMID). 

new_task_id: task_ptr 

This parameter indicates the address of the task that is the new owner of 
the specified port. 

Output status: boolean 

This parameter indicates whether or not ownership has been successfully 
changed. 
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CHANGE_TIMER_OWNER 

The requested timing function will have its allocating task id changed to the indicated 
task. If the indicated task equals NIL, the currently running task will be used as the 
new allocating task for the indicated timer. 

Comdeck CMXMTIM 

Format CHANGE _TIMER_OWNER (timer_id, task_id, status) 

Input timer _id: "timer 

This parameter indicates the timer entry associated with the timing 
procedure whose ownership is to be transferred. 

task _ id: task_ptr 

This parameter indicates the new allocating task for the indicated timing 
procedure. 

Output status: boolean 

This parameter indicates whether or not the procedure executed properly. 
A false status is returned if the timer_id or the task_id is invalid. 
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CHECKSUM _NEXT_MODULE 

Successively validates the section checksums of the next module. The procedure 
executes as follows: 

• The load_ identifier parameter is initially passed in as NIL in order to start with 
the first module. 

• The checksums for sections of the current module are successively calculated. These 
checksums are compared with the sums in the module header. If they are equal, 
then checksum_ valid is set to TRUE; otherwise, it is returned FALSE. 

• When the last module has been checksummed, the parameter next_module_found is 
returned with a value of FALSE. The module use count of the previous module is 
decremented and the current module is incremented. 

Comdeck DLXCKNM 

Format CHECKSUM_NEXT_MODULE (load .identifier, next _ module _found, 

checksum _ valid) 

input load .identifier: dlt$load_id_ptr 

This parameter indicates a record that specifies the module characteristics. 
It is initially set to NIL. 

Output load .identifier: dlt$load_id_ptr 

This parameter is used to pass to the CHECKSUM. NEXT_ MODULE call 
while looping. 

next _ module _ found: boolean 

This parameter returns TRUE until the end of the module header linked 
list is found. The parameter then returns FALSE. 

checksum. valid: boolean 

This parameter indicates whether the section checksum returned is equal 
to the section checksum from the time of initial load. 
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CHKSUM _IP _CMD _PKT 

DVM diagnostic services use this procedure to perform a checksum operation on a 
restart packet to be sent to a peripheral board. 

Comdeck DMXDIAG 

Format CHKSUM_IP_CMD_PKT (packet_ptr) 

Input packet_ptr: *ip_cmd_pkt_type 

This parameter indicates the address of the packet that is to have a 
checksum operation performed on it. 

Output None. 
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CLEAR .ALLOCATE 

This procedure allocates memory from the system heap and clears it to zero. If the 
memory cannot be allocated at the time of the call, the caller will yield the CPU until 
the memory request can be satisfied. 

Comdeck CMXCLAL 

Format address: = CLEAR .ALLOCATE (memory, bytes) 

input memory. bytes: 1 .. 32766 

This parameter indicates the number of bytes to be allocated. 

Output address: "cell 

This parameter returns the address of the memory allocated. 

Remarks The allocated memory will always be an even number of bytes and start at 
an even byte boundary. 

Use of this procedure is not recommended. Instead, the recommended 
technique is to allocate the record with the CYBIL allocate statement and 
then initialize the record by copying a pre-initialized static template. 
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CLEAR_MEMORY 

CLEAR .MEMORY 

This procedure clears a specified number of memory bytes. 

Comdeck CMXCLAL 

Format CLEAR_MEMORY (even _ start _ address, memory _bytes) 

input even _ start _ address: "cell 

This parameter indicates the starting address of memory to be cleared. It 
is assumed to be an even byte address. 

memory. bytes: .. 32766 

This parameter indicates the length of memory to be cleared. It is assumed 
to be an even number of bytes. 

Output None. 
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CLEAR_WRITE ^PROTECT 

This procedure clears the write protect flag. 

The write protect feature prevents user tasks from writing into MPB RAM. This adds a 
hardware level of security to prevent loss of the system., id and other configuration 
information. CLEAR_WRITE_PROTECT is called by a non-preemptible command 
processor task in order to change the configurable information. SET_WRITE_ 
PROTECT is always called to reenable the hardware protection. 

Comdeck CMICWP 

Format CLEAR _ WRITE .PROTECT 

input None. 

Output None. 

Remarks The proper use of this routine is in conjunction with SET_ WRITE _ 
PROTECT. The order of use should be: 

1. CLEAR. WRITE. PROTECT, 

2. modify the normally write-protected area of memory, and 

3. SET_WRITE_PROTECT. 
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CLOSE _ STATISTICS. SAP 

This procedure allows a software component to close a previously opened statistics SAP. 
Comdeck SMXSAPM 

Format CLOSE .STATISTICS. SAP (sap .id, element.type, element. name, 

status) 

Input sap_id: 0..0ffff(16) 

This parameter identifies the statistics SAP to be closed. 

element. type: statistics. type 

This parameter indicates the element type for which a statistics SAP is to 
be closed. 

element.name: string (* < = 31) 

This parameter indicates the name of the element for which a statistics 
SAP is to be closed. 

Output status: close .statistics .status 

This parameter returns the call status. 
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CLOSE _ STATUS. SAP 

This procedure allows software components to close previously opened status SAPs. 
Comdeck SDXSSAR 

CLOSE. STATUS. SAP (sap.number) 



Format 
Input 



Output 
Remarks 



sap_numben software_sap_range 

This parameter uniquely identifies the previously opened SAP that is to be 
closed. The sap_number must be the sap_number returned on the open_ 
status_sap call. 

None. 

The procedure NOPREMPT is called upon entering CLOSE_STATUS_SAP 
to suppress task preemption. CLOSE_STATUS_SAP is exited in a 
non-preemptable state; the caller must make a call to the procedure 
OKPREMPT if preemptability is desired. 

Global data modified: 

software_status_sap_ table. 
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CONVERT .INTEGER _TO_POINTER 

Converts an integer to a pointer for users who need to do pointer arithmetic. 

Comdeck CMIPCIP 

Format address := CONVERT_INTEGER_TO_POINTER (value) 

input value: integer 

This parameter indicates the integer to be converted. 

Output address: "cell 

This parameter returns the integer in pointer format. 

Remarks Use of this procedure should probably be restricted to hardware interface 
routines. 
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CONVERT_POINTER_TO_INTEGER 

CONVERT_POINTER_TO_INTEGER 

Converts a pointer to an integer for users who need to do pointer arithmetic. 

Comdeck CMIPCPI 

Format number := CONVERT_POINTER_TO_INTEGER (value) 

input value: "cell 

This parameter indicates the address to he converted. 

Output number: integer 

This parameter returns the integer value of the converted address. 

Remarks Use of this procedure should probably be restricted to hardware interface 
routines. 
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COPY 

This procedure copies a message to another buffer chain. The message is logically 
copied to new buffers, and the old set of buffers is released. 

Comdeck CMXPCPY 

Format COPY (message, threshold) 

input message: buf_ptr 

This parameter indicates the message to be copied. 

threshold: threshold. size 

This parameter indicates the threshold for buffer acquisition. 

Output message: buf_ptr 

This parameter returns the new buffer address of the copied message. 

Remarks The message parameter must be a valid buffer chain address. 
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DEAD_STOP 

DEAD_STOP 

This procedure calls RESET_DI with a reset code of software_dead_stop. 

Comdeck CMXPDED 

Format DEAD_STOP (halt_code) 

Input halt_code: .. 0ff(16) 

This parameter is required at compile-time, but is currently not used at 
run-time. 

Output None. 
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DECREMENT_MODULE _USE ..COUNT 

The module use count of the indicated entry point is decremented. If the count becomes 
zero, then the module is made available for deload. If the counter becomes negative, 
the system is reset and reloaded by DEAD_STOP. If the given entry point name is all 
blanks, then the module use count of the running task is decremented. This procedure 
is used when the module use count was previously incremented and procedure STOP_ 
TASK will not be called to decrement the counter. 

Comdeck DLXDMUC 

Format DECREMENT_MODULE_USE_COUNT (entry _point_name, entry, 

point _ found) 

input entry _ point _ name: pmt$program_name 

This parameter indicates the entry point of the module whose use count is 
to be decremented. 

Output entry _ point _ found: boolean 

This parameter returns an indication of whether the entry point was 
located. 
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DELAY_PROCESSING 

This routine may be called to delay processing for a finite period of time, as in a 
timeout mechanism. A normal return occurs when processing is resumed. 

Comdeck CMXPDLY 

Format DELAY .PROCESSING (hours, minutes, seconds, milliseconds) 

input hours: .. 24 

This parameter indicates the number of hours in the delay. 

minutes: .. 59 

This parameter indicates the number of minutes in the delay. 

seconds: .. 59 

This parameter indicates the number of seconds in the delay. 

milliseconds: .. 999 

This parameter indicates the number of milliseconds in the delay. 

Output None. 

Remarks The Executive CALL_AFTER_INTERVAL service is used to restart the 
task. The Executive guarantees that the requestor will wait at least as 
long as requested, but does not guarantee a maximum period. Thus, 
DELAY_PROCESSING (0,0,0,200) will delay at least 200 milliseconds, but 
may delay longer, even up to several seconds in a very busy system. 
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DEVICE _ STARTED 

This routine checks whether or not the peripheral board exists and has been started. 

Comdeck DMXXDS 

Format DEVICE .STARTED (ip_number) 

Input ip_number: .. upper_ip_num 

This parameter indicates the slot number of the peripheral board. 

Output status: boolean 

This parameter returns a boolean value of TRUE if the peripheral board 
has been started. FALSE is returned if the peripheral board does not exist 
or has not been started. 
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DI_DEBUG 

This procedure calls the DI Debugger from within a user program. 

If the DI Debugger program has already been initialized by a DI_ DEBUG request, it 
will retain its current trap state, enter its main input loop, and wait for Debugger 
commands to be entered through the DI console. 



Comdeck 


CMXDBUG 


Format 


DI.DEBUG 


Input 


None. 


Output 


None. 
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DI_DEBUG_INIT 

This procedure initializes the DI Debugger program to console break mode only. While 
the Debugger is in this mode, all of the available Debugger program error stops are 
enabled the first time a user presses the BREAK key (or enters a break 2 sequence) 
from the DI console. If the Debugger program has already been initialized, this request 
is ignored and the Debugger program is left in its current state. 

Comdeck CMXDBUG 

Format DI_ DEBUG. INIT 

Input None. 

Output None. 
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DUMP_CLOSE 

This procedure indicates to the dump task that the transfer of dump information is 
complete. 

Comdeck CMXSISA 

Format DUMP_CLOSE (sa_ dump .identifier) 

sa_ dump _ identifier: "cell 



Input 



Output 



This parameter indicates the address of the dump control block. 
None. 



Remarks If the sa_dump_identifier is not valid, no message will be sent and 
control returns to the caller. 
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DUMP_IP_MEMORY 

This procedure dumps the peripheral board's local RAM. This is done when either DVM 
or the peripheral's local RAM returns an error status when executing QUEUE_IP_ 
COMMAND. Failure management software then issues the DUMP_IP_MEMORY 
procedure to DVM. 

Comdeck DMXDIP 

Format DUMP_IP_MEMORY (dip_parm_ptr, image .location, status) 

Input dip_parm_ptR dip _parm_ptr_ type 

This parameter indicates the address of the command parameter packet. 
This record specifies the number of the peripheral, the address of the 
dump, and the length of the dump. 

Output image _ location: "cell 

This parameter returns the address of the image location where the 
dumped RAM is stored. This is located in SMM. 

status: 0..0ffff(16) 

This parameter returns the status of DUMP_IP_MEMORY. The status 
codes are: 

0: command executed. 

1: invalid card slot specified. 

2: start device service not issued for specified peripheral board. 

3: unable to procure memory for dump. 

4: peripheral board not responding to the dump command. 
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DUMP _ WRITE 

This procedure appends a header and dump information to the dump buffer chain 
associated with the dump identifier. If the total number of bytes in the buffer chain is 
above the maximum allowed in a dump buffer chain, then message(s) will be sent to 
the dump task identifying buffers to be immediately written to the dump file. This is 
used to capture any pertinent data during a recovery. 

Comdeck CMXSISA 

Format DUMP_WRITE (sa_ dump .identifier, dump _ address, dump_byte_ 

count, threshold) 

Input sa_ dump ..identifier: 'cell 

This parameter indicates the address of the dump control block. 

dump .address: "cell 

This parameter indicates the address of the information to be dumped. 

dump _ byte _ count: sat$max_ dump _ size 

This parameter indicates the number of bytes to dump; rounded up to an 
even number of bytes. 

threshold: threshold. size 

This parameter indicates the threshold to be used in obtaining buffers. 

Output None. 

Remarks If the sa_dump_ identifier is not valid, then the dump information will be 
discarded and control returns to the caller (the routine will abort). 
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FG_TRIM 

This procedure trims the specified number of bytes from the end of the data descriptor. 
If a buffer is completely used up, it is released from memory. If the entire message is 
less than the requested size, the caller is informed that there are not enough bytes to 
satisfy the request. 

Comdeck CMXPFGT 

Format FG_TRIM (size, address, message) 

input size: non_ empty _ message _ size 

This parameter indicates the number of bytes needed. 

address: "cell 

This parameter indicates where to position the bytes that are retrieved. 

message: buf_ptr 

This parameter indicates the destination address for any diagnostic 
message generated from the call. 

Output message: buf_ptr 

This parameter returns the address of any diagnostic message generated 
from the call. 
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FIELD _ SIZE 

This function converts a multiple of any of the Management Data Unit (MDU) field 
types to its length in bytes. 

Comdeck MEXGDF 

Format count := FIELD, SIZE (length, field. type) 

input length: 1 .. mdu_ field _ size 

This parameter indicates how many units of field_type there are in the 
MDU. 

field _ type: mdu_ field _ type 

This parameter indicates the MDU field type. 

Output count: .. mdu_ field _ size 

This parameter returns zero if an unsupported field type was specified; 
else, number of bytes. 
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FIND 

This procedure finds and returns the table in a tree that is associated with the 
specified integer key. The table is returned interlocked, (that is, task pre-emption from 
interrupt levels is disabled). 

Comdeck CMXPFIN 

Format address: = FIND (head, key) 

input head: "root 

This parameter indicates the root of the tree structure to be searched. 

key: integer 

This parameter indicates the key to be searched for. 

Output address: "cell 

This parameter returns the address of the table located by the FIND 
operation. If the key is not found, the return is NIL. 
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FIND _ FIRST 

This procedure searches the specified integer tree structure in left-node-right order for 
a node that contains a key greater than the input parameter, key. For each node that 
satisfies this condition, FIND_FIRST calls the user-supplied procedure (unless 
parameter qual is NIL). The search continues until the user-supplied procedure returns 
a value of TRUE (refer to appendix D). See also FIND_NEXT, SFIND_FIRST, and 
SFIND_NEXT. 

This procedure is identical to FIND_NEXT. 

Comdeck CMXPFNF 

Format table = FIND _ FIRST (head, qual, param, key) 

Input head: "root 

This parameter indicates the address of the head root of the tree structure 
to be searched. 

key: integer 

This parameter indicates the key associated with the node from which the 
search is to begin. 

qual: "procedure 

This parameter indicates the address of the procedure that will be called at 
each node. Refer to appendix D. 

param: "cell 

This parameter indicates the parameter to pass to qual. 

Output key: integer 

This parameter returns the key associated with the first table to satisfy 
the specified parameter, param. 

table: "cell 

This parameter returns the address of the first table to satisfy the 
specified parameter, param. 
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FIND_FREE_NODE 

This procedure finds the first key that is greater than the specified key and that is not 
associated with a table. The search is performed by comparing the key value passed in 
the call to the key.numeric value in the current node. 

Comdeck CMXPFFN 

Format FIND_FREE_NODE (head, key) 

input head: *root 

This parameter indicates the root of the tree to be searched. 

key: integer 

This parameter indicates the key used for comparison in the search. 

Output key: integer 

This parameter returns the first key value that is greater than the input 
key and that is not associated with a table. 
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FIND .NEXT 

This procedure searches the specified integer tree structure in left-node-right order for 
a node that contains a key greater than the input parameter, key. For each node that 
satisfies this condition, FIND_NEXT calls the user-supplied procedure (unless 
parameter qual is NIL). The search continues until the user-supplied procedure returns 
a value of TRUE (refer to appendix D). See also FIND_FIRST, SFIND_FIRST, and 
SFIND_NEXT. 

This procedure is identical to FIND_FIRST. 
Comdeck CMXPFNF 

table = FIND.NEXT (head, qual, param, key) 



Format 
Input 



Output 



head: "root 

This parameter indicates the address of the root of the tree structure to be 
searched. 

key: integer 

This parameter indicates the key associated with the node from which the 
search is to begin. 

qual: "procedure 

This parameter indicates the address of the procedure that will be called at 
each node. Refer to appendix D. 

param: "cell 

This parameter indicates the parameter to pass to qual. 

key: integer 

This parameter returns the key associated with the first table to satisfy 
the specified parameter, param. 

table: "cell 

This parameter returns the address of the first table to satisfy the 
specified parameter, param. 
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FIRST _BYTE .ADDRESS 

This procedure returns the address of the first byte of a message. It is intended for 
fast access by protocols that regularly make use of the first byte. 

Comdeck CMXPFBA 

Format byte _ address: = FIRST_BYTE_ ADDRESS (message) 

input message: buf_ptr 

This parameter indicates the message whose first byte address is sought. 

Output byte_address: "string (1) 

This parameter returns the first byte address of the specified message. 
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FIRST_NODE 

This procedure allocates space for the first node of a tree structure. Associated values 
are placed in the first node and the head node is linked to the first node. 

Comdeck CMXPNEW 

Format FIRST.NODE (head, key, table, size) 

input head: "root 

This parameter indicates the root of the tree structure. 

key: key _ record 

This parameter indicates the key to be associated with the first node, for 
searching operations. 

table: "node _ control 

This parameter indicates the address of the table to be associated with the 
first node. 

size: integer 

This parameter indicates the size in bytes of the specified table. 

Output None. 
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FORCE _STATISTICS_REPORTING 

This procedure forces the specified statistics function procedure to be called to issue a 
log message. 

Comdeck SMXSAPM 

Format FORCE_STATISTICS_REPORTING (sap_id, select _sds_hdr_ptr, 

param, status) 

Input sap_id: 0..0ffff(16) 

This parameter identifies the statistics SAP. 

select _sds_hdr_ptr: *sds_header 

This parameter indicates the SDS header to be used for logging. 

param: "cell 

This parameter indicates the parameter for the statistics function 
procedure. 

Output status: force _stat_ reporting _ status 

This parameter returns an indication of the call status. 
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FRAGMENT 

This procedure extracts a message fragment from the specified message. 
Comdeck CMXPFRA 

FRAGMENT (size, remainder _ptr, fragment_ptr, threshold) 



Format 
Input 



Output 



size: non_ empty _ message _ size 

This parameter indicates the byte length of the message fragment to be 
extracted. 

remainder _ptn buf_ptr 

This parameter indicates the address of the source message buffer. 

fragment _ptr: buf_ptr 

This parameter indicates the address of the buffer to which the fragment is 
to be moved. 

threshold: threshold. size 

This parameter indicates the threshold for buffer acquisition. 

remainder _ptn buf_ptr 

This parameter returns the address of the remaining portion of the source 
message buffer. This parameter will be set to NIL if the length of the size 
parameter is greater than the length of the source message buffer. 

fragment _ptn buf_ptr 

This parameter returns the address of the message fragment buffer. 
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GEN_DATA_FIELD 

This procedure generates a data field in MDU format. 

Comdeck MEXGDF 

Format GEN _ DATA _ FIELD (msgbuf, field_cell, length, type) 

Input msgbuf: buf_ptr 

This parameter points to the buffer containing the data field(s). 

field _ cell: "cell 

This parameter indicates the data field. 

length: l..mdu_ field _ size 

This parameter indicates the data field length. 

type: mdu_ field _ type 

This parameter indicates a data field type of MDU. Refer to Volume 3 of 
the Systems Programmer's Reference Manual for a complete description of 
MDU types. 

Output msgbuf: buf_ptr 

This parameter returns a pointer to the buffer containing the MDU data 
field(s). 



10-50 Base System Software 



Revision A 



GEN TEMPLATE ID 



GEN_TEMPLATE_ID 

This procedure puts template identifier fields into buffers for generation of log 
messages or command responses. Refer to the Command ME chapter of Volume 2 of 
the Systems Programmer's Reference Manual for information on log message and 
command response templates. 

Comdeck CSXGTI 

Format GEN .TEMPLATE. ID (msgbuf, template.id) 

input msgbuf: buf.ptr 

This parameter points to the buffer that contains the log message or 
command response data fields. 

template, id: template .id. type 

This parameter indicates the log message or command response template 
number. 

Output msgbuf: buf.ptr 

This parameter returns the buffer containing data field(s). 
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GET _ CARD _TYPE _AND _ ADDRESS 

This procedure gets the card type and card address for the device name specified. 

Comdeck SDXGCTA 

Format GET _ CARD _ TYPE _ AND .ADDRESS (device .name, device .record, 

device _ available) 

input device _name: string (*) 

This parameter indicates the hardware device name whose card type and 
address is desired. 

Output device .record: card .info .record 

This parameter returns the card type and card address for the device name 
specified. 

device .available: boolean 

If an invalid device name has been specified or if the associated board type 
is not physically available in the System Status Table, then this parameter 
returns FALSE; TRUE otherwise. 
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GET _CIM _BOOT _ SOURCE 

This procedure returns the LIM and port number over which a DI was booted. The 
user must know the slot number of the peripheral board over which the boot was 
loaded. 

Comdeck DMXXPS 

Format GET _ CIM _ BOOT _ SOURCE (ip_number, cim_number, port_number, 

status) 

input ip_numben Cupper _ip_num 

This parameter indicates the slot number of the peripheral board over 
which the DI was booted. 

Output cim_ number: 0..upper_cim_num 

This parameter returns the number of the CIM board for the specified 
DVMID. 

port _ number: O..upper_port_num 

This parameter indicates the number of the port over which the DI was 
booted. 

status: 0..0ffff(16) 

This parameter returns the status of GET_CIM_BOOT_ SOURCE. The 
status codes are: 

0: command executed. 

1: invalid board slot supplied. 

2: start device service not issued for specified peripheral board. 

3: unable to retrieve boot source. 

4: peripheral board not responding to request. 
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GET_CIM_NUMBER 

This DVM routine is used to determine the CIM slot number from the user supplied 
LIM and port numbers. 



Comdcck 

Format 

Input 



Output 



DMXXPS 

cim_number: = GET_CIM_NUMBER (lim_number, port_number) 

lim_numben 0..upper_lim_num 

This parameter indicates the slot number of the LIM board. 

port_number: Cupper _ port _num 

This parameter indicates the port number on the LIM board. 

cim_numbeK 0..upper_ip_num 

This parameter returns the CIM slot number for the specified LIM and 
port numbers. Range is 1..7. A return of signifies an invalid LIM or port 
number. 
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GET_DATA .FIELD 

This common procedure extracts data fields from MDU formatted messages and returns 
them in an internal format. Since a data field may consist of several subfields, the 
data is previewed to determine how much memory is needed. Then the fields are 
stripped until the field-complete flag is seen. 



Comdeck 

Format 

Input 

Output 



Remarks 



MEXGDF 

GET _ DATA _ FIELD (msgbuf, field_cell, len, type) 

msgbuf: buf_ptr 

This parameter points to a buffer containing the data unit. 

msgbuf: buf_ptr 

This parameter returns the updated pointer to buffer containing the data 
unit. 

field _cell: "cell 

This parameter returns the address of the data field. It will be equal to 
NIL if no more data is available or if any errors are encountered in the 
data fields. 

len: .. mdu_ field _ size 

This parameter returns the data field length. 

type: mdu_ field _ type 

This parameter returns the data field type. 

NOTE 

The caller is responsible for freeing the retrieved memory extent. 
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GET_EXPRESS, MAYBE .EXPRESS 



These procedures get ITMs from the express queue. If a message is found on the 
express queue, it is copied to the addressed space and removed from the ITM queue. 
The normal queue is not inspected. 

These calls have the following effects: 



GET_EXPRESS 

MAYBE_EXPRESS 
Comdeck CMXMTSK 



Control returns after a message has been made available 
to the caller. 

A message is obtained, or a failure is returned. 



Format GET _ EXPRESS (intertask _ message, task _ sending _ message) 

MAYBE_EXPRESS (intertask _ message, task _ sending _ message) 

Input None. 

Output intertask _ message: *cell 

This parameter returns the address of the dequeued ITM. 

task _ sending _ message: task.ptr 

This parameter returns the task_id of the task that sent the ITM. 
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GET_FIRST_BYTE 

This function returns the first valid byte of text from the specified message in the form 
of a character. It provides fast access to protocols that regularly make use of the first 
byte. 

Comdeck CMXPGFB 

Format byte:= GET _ FIRST _ BYTE (message) 

input message: buf_ptr 

This parameter indicates the message whose first byte of text is to be 
returned. 

Output byte: char 

This parameter returns the first byte of the specified message. 
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GET_LAST_BYTE 

This function returns the last valid byte of text from the specified message in the form 
of a character. 

Comdeck CMIGLB 

Format byte:= GET _ LAST _ BYTE (message) 

input message: buf_ptr 

This parameter indicates the first descriptor of the message whose last 
byte of text is to be returned. 

Output byte: char 

This parameter indicates the last byte of the specified message. 

Remarks It is assumed that the last buffer in the chain will not be empty. 
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GET_LONG .BUFFERS, FG_LONG_BUFFERS, MAYBE _LONG_ 
BUFFERS 

These procedures get one or more data buffers, with the following variations: 



GET_LONG_BUFFERS 
FG_ LONG_ BUFFERS 

MAYBE_LONG_BUFFERS 
Comdeck CMXPGBF 



The buffers are obtained. 

For interrupt routine use only; the buffers are 
obtained or a failure is returned. 

The buffers are obtained or a failure is returned. 



Format GET _ LONG .BUFFERS (count, buffer .address, threshold) 

FG.LONG.BUFFERS (count, buffer .address, threshold) 
MAYBE. LONG .BUFFERS (count, buffer .address, threshold) 

input count: buffer. request.limit 

This parameter indicates the number of buffers being requested. 

threshold: threshold .size 

This parameter indicates the threshold for obtaining buffers. 

Output buffer. address: buf.ptr 

This parameter returns the address of the buffer chain obtained. 
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GET_MEMORY, FG_MEMORY, MAYBE .MEMORY 

These procedures get global memory extents, with the following effects: 



GET_MEMORY 
FG.MEMORY 

MAYBE_MEMORY 



Comdeck 

Format 

Input 
Output 



The memory extent is obtained. 

For interrupt routine use only; the memory extent 
is obtained or a failure is returned. 

The memory extent is obtained or a failure is 
returned. 



CMXPGGX 



GET.MEMORY (extent .returned, extent_size) 
FG_MEMORY (extent.returned, extent.size) 
MAYBE .MEMORY (extent .returned, extent.size) 

extent, size: executive .extent 

This parameter indicates the size of the memory extent to be obtained. 

extent .returned: *cell 

This parameter returns the address of the memory extent obtained. 
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GET_MESSAGE_LENGTH 

This function returns the byte length of the specified message. 

Comdeck CMXPGML 

Format size: = GET_MESSAGE_LENGTH (message) 

input message: buf_ptr 

This parameter indicates the address of the message to be measured. 
Output size: message _ size 

This parameter returns the length in bytes of the message specified. 

Remarks If the address of the message is NIL, then the output parameter returns a 
value of zero. 
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GET _MPB .EXTENT, FG_MPB_EXTENT, MAYBE_MPB_ 
EXTENT 

These procedures get MPB RAM memory extents with the following effects: 



GET_MPB_EXTENT 
FG_MPB_EXTENT 

MAYBE_MPB_EXTENT 



Comdeck 
Format 

Input 
Output 



The memory extent is obtained 

For interrupt routine use only; the memory extent 
is obtained or a failure is returned. 

The memory extent is obtained or a failure is 
returned. 



CMXPGMP 



GET _ MPB _ EXTENT (extent. returned, extent.size) 
FG_MPB_EXTENT (extent .returned, extent_size) 
MAYBE. MPB .EXTENT (extent .returned, extent.size) 

extent .size: executive .extent 

This parameter indicates the size of the MPB extent to be obtained. 

extent.returned: "cell 

This parameter returns the address of the MPB extent obtained. 
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GET_MSG, MAYBE _MSG 

These procedures get ITMs from the normal or express queues. If a message is found 
on either the normal or express queue, it is copied to the addressed space, and 
removed from the ITM queue. The express queue has priority. These calls have the 
following effects: 

GET_MSG Control returns after a message has been made available 

to the caller. 

MAYBE_MSG A message is obtained, or a failure is returned. 

Comdeck CMXMTSK 

Format GET_MSG (intertask _ message, sender) 

MAYBE _MSG (intertask _ message, sender) 

Input None. 

Output intertask .message: "cell 

This parameter returns the address of the dequeued ITM. 

sender: task_ptr 

This parameter returns the task_id of the task that sent the ITM. 
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GET _NEXT_ STATUS. SAP 

Provides a command processor the ability to retrieve the addresses of its associated 
software components' status tables when multiple copies are executing at the same 
time. 



Comdeck 
Format 

Input 



Output 



Remarks 



SDXSSAR 

GET_NEXT_STATUS_SAP (name, last_sap_table_ptr, next_sap_ 
table_ptr, task_id, successful, response) 

name: string ( * < = 31) 

This parameter indicates the name of the software component of interest. 
last _ sap _ table _ptr: "cell 

This parameter indicates the address of the status table of the previously 
obtained SAP. This parameter should be set to the returned value of the 
parameter next_sap_table_ptr from the previous call when GET_NEXT_ 
STATUS_SAP is being used recursively. 

If no previous SAP was obtained, this parameter should be set to NIL. 
next _ sap _ table _ptr: "cell 

This parameter returns the address of the software components status table 
of the next registered SAP in the table. 

If the specified value of last_sap_table_ptr is NIL, then next_sap_table_ 
ptr will contain the address of the first associated status SAP for the 
named software component. 

If the next_sap_table_ptr is returned NIL, then the software component 
has not opened a status SAP or it has no status to report. Or, if the 
procedure is being used recursively, NIL will be returned when all the 
associated SAPs have been retrieved. 

task _ id: task _ ptr 

This parameter returns the task_id of the software component that opened 
the software status SAP. 

successful: boolean 

This parameter returns TRUE if the last_sap_table_ptr was found; 
FALSE otherwise. 

response: buf_ptr 

This parameter contains a response to be sent to the origin of the 
command if its value is not NIL. 

The procedure NOPREMPT is called when entering GET_NEXT_ 
STATUS. SAP to suppress task preemption; GET_NEXT_ STATUS. SAP is 
exited in a non-preemptible state. You must make a call to the procedure 
OKPREMPT if preemptibility is so desired. 
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GET _PMM .EXTENT, FG_PMM_ EXTENT, MAYBE_PMM_ 
EXTENT 

These procedures obtain private memory extents, with the following effects: 



GET_PMM_EXTENT 
FG_PMM_EXTENT 

MAYBE_PMM_EXTENT 



Comdeck 
Format 

Input 
Output 



The memory extent is obtained 

For interrupt routine use only; the memory extent 
is obtained or a failure is returned. 

The memory extent is obtained or a failure is 
returned. 



CMXPGPM 



GET _PMM_ EXTENT (extent_returned, extent_size) 
FG_PMM_ EXTENT (extent .returned, extent_size) 
MAYBE _PMM_ EXTENT (extent .returned, extent_size) 

extent _ size: executive. extent 

This parameter indicates the size of the private memory extent to be . 
obtained. 

extent .returned: "cell 

This parameter returns the address of the private memory extent obtained. 
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GET_SHORT_BUFFERS, FG_SHORT_BUFFERS, MAYBE 
SHORT_BUFFERS 

These procedures get one or more descriptor buffers, with the following effects: 

GET_SHORT_ BUFFERS The buffers are obtained. 



FG_ SH ORT_ BUFFERS 



For interrupt routine use only; the buffers are 
obtained or a failure is returned. 



MAYBE_SHORT_BUFFERS The buffers are obtained or a failure is returned. 
Comdeck CMXPGDB 

Format GET_SHORT_BUFFERS (count, buffer. address, threshold) 

FG_SHORT_BUFFERS (count, buffer .address, threshold) 
MAYBE _ SHORT. BUFFERS (count, buffer .address, threshold) 

input count: buffer .request, limit 

This parameter indicates the number of buffers to be obtained. 

threshold: threshold .size 

This parameter indicates the threshold for obtaining buffers. 

Output buffer.address: buf.ptr 

This parameter returns the address of buffer chain obtained. 
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GET_SIZE_N_ADDR 

This procedure gets the size and address of the memory extent for the specified section. 
The size and address are determined from the indicated start section address. 



Comdeck 

Format 

Input 

Output 



Remarks 



SIXGSIZ 

GET_SIZE_N_ADDR (section .address, section_size) 

section _ address: "cell 

This parameter indicates the section of interest. 

section _ address: "cell 

This parameter returns the address of the section whose size is being 
returned. 

section _ size: Ut$section_ length 

This parameter returns the size of the specified section. 

NOTE 

Output parameter section_address will be 6 bytes less than input 
parameter section_ address. 
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GET _ STATUS _ RECORD 

This procedure retrieves a status record for the device name specified. 

If an invalid device name is specified or the associated board type is not physically 
available in the associated System Status Table, then a status indication is returned 
that indicates that the device named is not available in the DI. 



Comdeck 
Format 

Input 
Output 



SDXGPSR 

GET _ STATUS _ RECORD (device _ name, device _ status _ record, 
device _ available) 

device _ name: string (maximum _ device _ name _ size) 

This parameter identifies the hardware device name whose status record is 
desired. 

device _ status _ record: component _ status _ type 

This parameter returns the status record for the device name specified. 

device _ available: boolean 

If the device named is in the DI, TRUE is returned; FALSE otherwise. 
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GET _ STATUS _ SAP 

The purpose of this procedure is to provide a command processor the ability to retrieve 
the address of its associated software component status table. 

Comdeck SDXSSAR 

Format GET _ STATUS. SAP (name, sap _ table _ptr, task_id, response) 

input name: string ( * < = 31) 

This parameter indicates the name of the software component of interest. 

Output sap _ table _ptr: "cell 

This parameter returns the address of the software components status 
table. 

If the sap_table_ptr is returned NIL, then either the software component 
has not opened a status SAP or it has no status to report. 

task_id: task_ptr 

This parameter returns the task_id of the software component who opened 
the software status SAP. 

response: buf_ptr 

This parameter returns a response to be sent to the origin of the command 
if its value is not NIL. 

Remarks The procedure NOPREMPT is called when entering get_status_sap to 
suppress task preemption. GET_STATUS_SAP is exited in a 
non-preemptible state and will require the caller to make a call to the 
procedure OKPREMPT if preemptibility is so desired. 
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GROW 

This procedure adds a new table to a tree structure. 

Comdeck CMXPGRO 

Format address: = GROW (head, key, table, size) 

input head: "root 

This parameter indicates the root of the tree. 

key: integer 

This parameter indicates the key to be used for searching operations. 

table: "cell 

This parameter indicates the table to be added to the tree. 

size: integer 

This parameter indicates the table size. 

address: * cell 



Output 



Remarks 



If an association already exists between the specified key and the table 
structure, the table is returned and no update is performed. Otherwise, the 
association is created and NIL is returned. 

The procedure NOPREMPT is called upon entering GROW to suppress task 
preemption. GROW is exited in a non-preemptible state and will require 
the caller to make a call to the procedure OKPREMPT if preemptibility is 
so desired. 
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I_COMPARE 

This function compares the lengths of two strings. 
Comdeck INXCMP 

result: = I .COMPARE (stringl, string2) 



Format 
Input 



Output 



stringl: string (*) 

This parameter indicates the first of two strings specified for comparison. 
Length may be up to 256 characters. 

string2: string (*) 

This parameter indicates the second of two strings specified for comparison. 
Length may be up to 256 characters. 

result: -1..1 

If stringl < string2, the return is -1. 

If stringl = string2, the return is 0. 

If stringl > string2, the return is 1. 



Revision A 



Procedures and Functions 10-71 



I_COMPARE COLLATED 



I .COMPARE ..COLLATED 

This function translates characters in two strings according to a translation table, and 
compares the strings. 



Comdeck 

Format 

Input 



Output 



INXCMPC 

result: = I .COMPARE .COLLATED (stringl, string2, table) 

stringl: string ( * ) 

This parameter indicates the first of two strings specified for comparison. 
Length may be up to 256 characters. 

string2: string (*) 

This parameter indicates the second of two strings specified for comparison. 
Length may be up to 256 characters. 

table: string (256) 

This parameter indicates the translation table. 

result: -1..1 

If stringl < string2, the return is -1. 

If stringl = string2, the return is 0. 

If stringl > string2, the return is 1. 
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I_SCAN 

This procedure scans a string from left to right until one of a specified set of 
characters is found, or until the entire string has been searched. 

Comdeck INXSCAN 

Format I _ SCAN (select, string, index, found _ char) 

Input select: "packed array [char] OF boolean 

This parameter indicates the address of the set of elements that the string 
is to be searched for. 

string: string (*) 

This parameter indicates the string to be searched. 

Output index: integer 

This parameter returns the location from the left-most character of the 
string of the character that was found. 

found. char: boolean 

This parameter returns an indication of whether or not any of the specified 
characters has been found. 
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I .TRANSLATE 

This procedure translates each character in a source field according to a translation 
table, and transfers the result to a destination field. 

Comdeck INXTRAN 

Format I .TRANSLATE (table, source, destination) 

input table: string (256) 

This parameter specifies the translation table. 

source: string (*) 

This parameter indicates the string to be translated. Length may be up to 
256 characters. 

destination: string (*) 

This parameter indicates the destination of the string to be translated. 
Length may be up to 256 characters. 

Output destination: string (*) 

This parameter returns the destination of the translated string. Length 
may be up to 256 characters. 

Remarks If the length of the source field is less than the length of the destination 
field, translated blanks fill the destination field. If the source field is 
larger than the destination field, the right-most characters of the source 
field are truncated in the destination field. 
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INCREMENT_MODULE _USE _COUNT 

This procedure increments the module use count of a loaded module, thus preventing 
module deloading. This procedure is only used when START_NAMED_TASK, LOAD_ 
ENTRY_POINT or LOAD_ABSOLUTE_MODULE have not been used to prevent 
module deloading. 

Comdeck ILXIMUC 

Format INCREMENT_MODULE_USE_COUNT (entry _point_name, entry. 

point_found) 

Input entry _ point _ name: pmt$program_name 

This parameter indicates the entry point of the module whose use count is 
to be incremented. If the specified entry point name is all blanks, then the 
module use count of the currently running task is incremented. 

Output entry _ point _ found: boolean 

This parameter returns an indication of whether or not the module was 
found. 
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INIT_ROOT 

This procedure initializes the root of a tree. This includes setting up initial values for 
interlocks and node addresses, as well as setting up the (up to) four character ASCII 
name of the table stored in each node. 

Comdeck CMIPINT 

Format INIT_ROOT (root, type_node, name) 

Input root: "root 

This parameter indicates the root of the tree structure that is to be 
initialized. 

type _ node: key _ type 

This parameter indicates the key type to be used in referencing the tree 
structure's nodes. 

name: string (4) 

This parameter indicates the ASCII name of the table to be stored in each 
node. 

Output None. 
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INITIALIZE _ STATISTIC .RECORD 

This procedure will initialize MDU formatted records used in statistics collection. 
Comdeck SMXSAPM 

Format INITIALIZE_STATISTIC_RECORD (number_of_records, number. 

of_data_ bytes, record _ starting _ptr) 

input number_of_reeords: 1..0ff(16) 

This parameter indicates the number of records to initialize. 

number _of_ data _ bytes: number_of_data_byte_types 

This parameter indicates the need for a two-, four- or eight-byte statistic 
record. 

record _ starting _ptr: "cell 

This parameter is a pointer to the starting record. 

Output record _starting_ptr: "cell 

This parameter returns a pointer to the next record. 
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LOAD _ ABS ^MODULE _ AND _DELAY 

This procedure loads an absolute module if it is not currently loaded. If the module is 
already loaded, information is returned pertaining to the module. The caller waits 
while loading occurs. 

Comdeck DLXLAMD 

Format LOAD_ABS_MODULE_AND_DELAY (module_name, smm_address, 

load.address, transfer _ address, byte_size, absolute _ module. found, 
error _ response) 

input module _name: pmt$program_name 

This parameter indicates the module to be loaded. Maximum length of 
string is 31 characters. 

Output smm_ address: "cell 

This parameter returns the starting address of the module in SMM. 

load .address: dlt$68000_ address 

This parameter returns the address where the module has been loaded. 

transfer .address: dlt$68000_ address 

This parameter returns the address at which module execution begins. 
Range is .. 7fffffff(16). 

byte _ size: dlt$section_ length 

This parameter returns the size of the module in bytes. 

absolute .module .found: boolean 

This parameter indicates whether or not the module was found. 

error .response: clt$status 

Any error message from the Online Loader is returned by this parameter. 

Remarks The module use count is incremented to prevent module deloading. 

If the parameter absolute_module_found is returned FALSE, it is the 
user's responsibility to release the buffer chain returned in error_ 
response.condition. 
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LOAD _ ABS .MODULE _ AND .PROCEED 

This procedure returns information pertaining to a named module if it is already 
loaded. If it is not loaded, the procedure sends an ITM to the Online Loader to load 
the module. The calling procedure continues to operate while the Online Loader is 
processing the request. 

Comdeck DLXLAMP 

Format LOAD_ABS_MODULE_AND_PROCEED (module. name, reply_ 

procedure, request_id) 

input module _ name: pmt$program_name 

This parameter indicates the module to be loaded. Maximum length of 
string is 31 characters. 

reply _ procedure: "procedure 

This parameter indicates the address of a procedure that returns 
information about the module to the original calling procedure. Refer to 
appendix D. 

request. id: *cell 

This parameter indicates the address of an identifier. If the calling 
procedure is making more than one request for the module, this identifies 
the request. 

Output None. 

Remarks The module use count is incremented to prevent module deloading. 

This procedure makes use of a reply procedure to capture returned 
information while processing continues. 

If the parameter absolute_module_found is returned FALSE to the reply 
procedure, it is the user's responsibility to release the buffer chain 
returned in error_response.condition. 
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LOAD _CMD _PROCESSOR _ AND _DELAY 

Given a command processor name, this procedure loads a module if it is not currently 
loaded. The task attribute block is found and validated (defaults are used on error), 
and entry point information is returned. The caller waits while loading occurs. 

Comdeck DLXLCPD 

Format LOAD_CMD_PROCESSOR_AND_DELAY (entry, point _ name, 

entry _ point _ found, entry _ address, task _ info, error _ response, 
module _ptr) 

input entry _ point _ name: pmt$program_name 

This parameter specifies the name of the entry point of the module to be 
loaded. . 

Output entry _ point _ found: boolean 

This parameter indicates whether the specified entry point was found. 

entry _ address: *dlt$en try .description 

This parameter returns the address of the loaded module entry point. 

task_info: task _ attributes 

This parameter returns the stack size, priority, task preemptibility, and an 
indication of whether or not the task is immediate control. Refer to 
appendix C. 

error _ response: clt$status 

This parameter returns any error message generated by the Online Loader. 

module _ptn dlt$load_id_ptr 

This parameter returns the address of the loaded module. 

Remarks The module_use_count is incremented to prevent module deloading. 

If the parameter entry _point_found returns FALSE, it is the user's 
responsibility to release the buffer chain returned in error_ 
response.condition. 
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LOAD_CMD_PROCESSOR_AND_PROCEED 

Given a command processor name, this procedure loads a module if it is not currently 
loaded. The task attribute block is found and validated (defaults are used on error), 
and entry point information is returned. The calling procedure continues to operate 
while the Online Loader is processing the request. 

Comdeck DLXLCPP 



Format 



Input 



Output 
Remarks 



LOAD_CMD_PROCESSOR_AND_PROCEED (entry _ point _ name, 
reply _ procedure, request _ id) 

entry _point_name: pmt$program_name 

This parameter indicates the entry point of the module to be loaded. 
Maximum length is 31 characters. 

reply _procedure: "procedure 

This parameter indicates the address of a procedure that returns 
information about the module to the original calling procedure. Refer to 
appendix D. 

request_id: "cell 

This parameter indicates the address of an identifier. If the calling 
procedure is making more than one request for the module, this identifies 
the request. 

None. 

The module_use_count is incremented to prevent module deloading. 

This procedure makes use of a reply procedure to capture returned 
information while processing continues. 

If the parameter entry_point_found returns FALSE to the reply procedure, 
it is the user's responsibility to release the buffer chain returned in error_ 
resonse.condition. 
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LOAD_ENTRY_POINT_AND_DELAY 

Given an entry point name, this procedure loads the associated module unless it is 
currently loaded. If the load fails, an error message is returned in the parameter 
error_response. The task attribute block is found and validated (defaults are used on 
error). Entry point information is returned. The caller waits while loading occurs. 



Comdcck 
Format 

Input 
Output 



Remarks 



DLXLEPD 

LOAD_ENTRY_POINT_AND_DELAY (entry _point_name, entry. 
point_found, entry _ address, task_info, error _ response, module_ptr) 

entry_point_name: pmt$program_name 

This parameter indicates the entry point of the module to be loaded. 
Maximum length is 31 characters. 

entry _ point _ found: boolean 

This parameter returns an indication of whether the specified entry point 
was found. 

entry _ address: "dlt$entry _ description 

This parameter returns the address of the loaded module entry point. 

task _ info: task .attributes 

This parameter returns the stack size, priority, task preemptibility, and an 
indication of whether or not the task is immediate control. Refer to 
appendix C. 

error_response: clt$status 

This parameter returns any error message generated by the Online Loader. 

module _ ptn dltSload _ id _ ptr 

This parameter returns the address of the loaded module. 

The module_use_count is incremented to prevent module deloading. 

If the parameter entry_point_found is returned FALSE, it is the USER'S 
responsibility to release the buffer chain returned in error_ 
response.condition. 
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LOAD _ENTRY_POINT_AND .PROCEED 

Given an entry point name, this procedure loads the associated module unless it is 
currently loaded. If the load fails, an error message is returned in the parameter 
error_response. The task attribute block is found and validated (defaults are used on 
error). Entry point information is returned. The calling procedure continues to operate 
while the Online Loader is processing the request. 



Comdeck 



Format 



Input 



Output 
Remarks 



DLXLEPP 

LOAD_ENTRY_POINT_AND_PROCEED (entry _point_name, reply, 
procedure, request_id) 

entry _ point _ name: pmt$program_name 

This parameter indicates the entry point of the module to be loaded. 
Maximum length is 31 characters. 

reply .procedure: "procedure 

This parameter indicates the address of a procedure that returns 
information about the module to the original calling procedure. Refer to 
appendix D. 

request_id: "cell 

This parameter indicates the address of an identifier. If the calling 
procedure is making more than one request for the module, this identifies 
the request. 

None. 

The module_use_count is incremented to prevent module deloading. 

This procedure makes use of a reply procedure to capture returned 
information while processing continues. 

If the parameter entry_point_found is returned FALSE to the reply 
procedure, it is the user's responsibility to release the buffer chain 
returned in error _ response. condition. 
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M_RELEASE 

This procedure executes the specified number of message release operations. 

Comdeck CMIPMLR 

Format M_ RELEASE (message, count) 

input message: buf_ptr 

This parameter indicates the address of the descriptor buffer containing the 
address of the message whose usage count is to be decremented. 

count: 1 .. 32767 

This parameter indicates the number of usage counts to be subracted from 
the message. 

Output message: buf_ptr 

This parameter returns the address of the descriptor buffer containing the 
address of the message whose usage count has been decremented. 

Remarks This procedure has the same effect as multiple release _ message requests. 
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MAYBE _TASK 

This procedure will start a task at the specified entry point and establish a parent task 
to child task relationship. A task that starts another task using this call becomes the 
parent task; the new task is referred to as the child task. The Executive sends 
messages to parent tasks regarding errant child tasks. The Executive, in this case, 
returns control whether or not the task was started. 



Comdeck 

Format 

Input 



Output 



Remarks 



CMXMTSK 

MAYBE_TASK (module_ptr, task .attributes, start_at, task) 

module _ptn dlt$load _id _ptr 

This parameter indicates a pointer to the task's module header information. 

task _ attributes: task _ attributes 

This parameter indicates a record specifying stack size, priority, and 
whether or not the task is preemtable. 

start _ at: "procedure 

This parameter indicates the address of the entry point to the task 
procedure. 

task: task_ptr 

If the task started, the task ID is returned. NIL is returned if the 
procedure fails. 

NOTE : 

START_NAMED_TASK_AND_DELAY is the recommended procedure to 
call for starting a task. 
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MDU_TO_ ASCII 

Converts MDU syntax to ASCII. 

This routine converts a buffer with management data syntax to a buffer containing an 
ASCII string. No extra data is added. That is, no extraneous -CR- or -LF- 's are added 
to the converted data. If they are desired they must already be in the buffer to be 
converted. Note that data is appended to the receiving buffer. If there is none, set the 
buffer pointer to NIL first. 

The various field types are converted as follows: 

binary string: ASCII O's and l's 

binary octet: converted to hexadecimal ASCII digits 

character octets: none (already is ASCII) 

binary integer: converted to decimal ASCII digits 

binary unsigned integer: converted to decimal ASCII digits 

bed: converted to decimal ASCII digits 

format: converted to -LF- / -CR- sequence 

Comdeck MEXM2A 

Format MDU_TO_ASCII (mdubuf, msgbuf) 

input mdubuf: buf_ptr 

This parameter indicates the address of the buffer containing the data to 
be converted to ASCII format. 

msgbuf: buf_ptr 

This parameter specifies the buffer to receive the ASCII data. 

Output mdubuf: buf_ptr 

This parameter returns the address of the buffer containing the original 
data. 

msgbuf: buf_ptr 

ASCII data is appended to this buffer. 



10-86 Base System Software 



Revision A 



MESSAGE_DEQUEUE 

MESSAGE .DEQUEUE 

This procedure extracts a message from the specified task-level message queue. 

Comdeck CMXPQUE 

Format MESSAGE .DEQUEUE (queue, message, time .interval) 

input queue: qcb_ptr 

This parameter identifies the queue to be dequeued from. 

message: buf_ptr 

This parameter indicates the address for the dequeued message. 

Output message: buf_ptr 

This parameter returns the address of the dequeued message. 

time .interval: integer 

This parameter returns the amount of time, in milliseconds (accurate to 
100 milliseconds) that the message remained in the queue. 

Remarks This is a special high speed dequeuing routine specifically for the use of 
protocol drivers and interlayer interfaces where data traffic is queued. 
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MESSAGE .ENQUEUE 

This procedure places a message in the specified task-level message queue. 

Comdeck CMXPQUE 

Format MESSAGE .ENQUEUE (queue, message) 

input queue: qcb_ptr 

This parameter indicates the address of the Queue Control Block of the 
queue to be enqueued. 

message: buf_ptr 

This parameter indicates the message to be enqueued. 

None. 



Output 
Remarks 



This is a special high-speed enqueuing routine specifically for the use of 
protocol drivers and inter-layer interfaces where data traffic is queued. 
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MODIFY. WRITE _PROTECT_BYTE 

This procedure modifies a byte in MPB write-protected RAM. After the field is updated, 
MPB RAM write-protect is again set. 

Comdeck CMXMWPB 

Format MODIFY_WRITE_PROTECT_BYTE ("byte, new_value) 

Input "byte: "cell 

This parameter indicates the pointer to the write-protected byte to be 
changed. 

new _ value: .. 0ff(16) 

This parameter indicates the new value for the specified byte. 

Output None. 

Remarks This routine will only work on bytes. 
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MODIFY .WRITE .PROTECT .LONG .WORD 

This procedure modifies a long word in MPB write-protected RAM. After the field is 
updated, MPB RAM write-protect is again set. 

Comdeck CMXMWPL 

Format 



MODIFY_WRITE_PROTECT_LONG_WORD Clong_word, new. 
value) 



Input "long_word: "cell 

This parameter indicates the pointer to the write-protected long word to be 
changed. 

new _ value: integer 

This parameter indicates the new value for the specified long word. 

Output None. 

Remarks This routine will only work on long words. 



10-90 Base System Software 



Revision A 



MODIFY_WRITE_PROTECT_SHORT_WORD 



MODIFY_WRITE_PROTECT_SHORT_WORD 

This procedure modifies a short word in MPB write-protected RAM. After the field is 
updated, MPB RAM write-protect is again set. 

Comdeck CMXMWPS 

Format MODIFY. WRITE _PROTECT_SHORT_ WORD (*short_word, new_ 

value) 

input A short_word: "cell 

This parameter indicates the pointer to the write-protected short word to 
be changed. 

new_value: .. 0ffff(16) 

This parameter indicates the new value for the specified short word. 

Output None. 

Remarks This routine will only work on short words. 
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NAME_MATCH 

This function compares a name string with a model. The name string may contain wild 
card attributes. If the two strings conform (match), the function returns a TRUE value; 
otherwise, it returns FALSE. 

The following characters have special meaning. These characters may be used in the 
name string as wild card entries. 

[ ... ] Any single character among those in brackets. 

a - z Within a bracketed group, a range of characters is represented with a 

dash (-). For example, "a - z", where "a" and "z" are any two characters 
for which the expression a <= zora >= zis accepted. 

* Any character string including the NULL string. 
? Any single character. 

* If the model contains any special characters, those special characters (*, 
[, ?) must be surrounded with single quotes. If the model contains a 
single quote, 2 single quotes must be in the name. Example: the name 
string A'*'B matches the model string A*B, and the name string A"B 
matches the model string A'B. 

Comdeck CSXPNAM 

Format result := NAME _ MATCH (name, model) 

Input name: string(*) 

This parameter indicates the name to be compared. 

model: string(*) 

This parameter indicates the model to compare against. 

Output result: boolean 

This parameter returns an indication of whether or not the named string 
matched the model. 

Remarks if a '?' special character is followed by an '*' special character (i.e: ?*) the 
'*' special character is considered the NULL string. 

Special characters are not recgonized within a bracketed group. 
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NEW_INTERRUPT 

This procedure will program the specified vector with the address of a new interrupt 
service routine. When this service is used, the caller becomes the parent task to the 
interrupt routine, which is referred to as the child task. The Executive will send the 
parent messages with workcodes in the range 0..15 regarding errant children. Refer to 
the appendix F for explanation of these values. 

Comdeck CMXMTSK 

Format NEW _ INTERRUPT (vector, server, task.id) 

input vector: 2 .. 255 

This parameter specifies the vector number that will point to the new 
interrupt service routine. Appendix E lists the interrupt vector numbers. 

server: "procedure 

This parameter indicates the address of the procedure that will process the 
interrupt vector. 

Output task_id: task_ptr 

This parameter returns the address of the task servicing the interrupt 
service routine. If the interrupt_ routine parameter contains an invalid 
address, either an address error interrupt or a bus error is issued. 
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NEW .PRIORITY 

This procedure changes a task's priority to the requested level. 

Comdeck CMXMTSK 

Format NEW .PRIORITY (requested .priority, task, status) 

input requested .priority: priorities 

This parameter indicates the task's new priority. 

task: task.ptr 

This parameter indicates the task whose priority is to be changed. 

Output status: boolean 

This parameter returns an indication of whether or not the procedure was 
successful. 
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NOPREMPT 

This procedure suppresses the task preemption capability. 
Comdeck CMXPPRM 

Format NOPREMPT 

Input None. 

Output None. 
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OKPREMPT 

This procedure restores the task preemption capability. 
Comdeck CMXPPRM 

Format OKPREMPT 

input None. 

Output None. 
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OPEN _ STATISTICS _ SAP 

This procedure allows a software component that is collecting statistics to make itself 
known to the CDCNET Statistics Manager (CSM). The combination of element_type 
and element_name defines a SAP entry. Each sds_ header specifies a different group. 

Comdeck SMXSAPM 

Format OPEN _ STATISTICS. SAP (element.type, element_name, sds_ 

header_ptr, report_interval, sap_id, status) 

input element. type: statistics. type 

This parameter indicates the element type for which statistics are to be 
gathered. 

element. name: string (* <= 31) 

This parameter indicates the name of the element for which statistics are 
to be gathered. 

sds. header .ptr: "sds.header 

This parameter indicates the pointer to a chain of one or more sds_ 
headers. 

report.interval: 1..60 * 60 * 24 

This parameter indicates the interval for statistical reporting period. The 
maximum interval allowed is 24 hours. 

Output sap .id: 0..0ffff(16) 

This parameter identifies the opened SAP. 

status: open .statistics .status 

This parameter returns the call status. 
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OPEN _ STATUS. SAP 

This procedure allows a software component to register the address of its status table 
by opening a software status SAP. A software component may call the OPEN_ 
STATUS_SAP routine after it is initialized and is capable of reporting status. 



Comdeck 
Format 

Input 



Output 



Remarks 



SDXSSAR 

OPEN _ STATUS. SAP (name, task.id, sap _ table _ptr, sap_number, 
status) 

name: string (* < = 31) 

This parameter indicates the module name of the software component for 
which a SAP is to be opened. 

task_id: task_ptr 

This parameter identifies the task_id of the software component who will 
open the software status SAP. 

sap_table_ptr: "cell 

This parameter identifies the address of the software components status 
table. 

sap _ number: software _ sap _ range 

This parameter uniquely identifies the status SAP opened. The sap_ 
number must be used when later closing a status SAP. 

status: access _ status. type 

This parameter indicates if the SAP requested was opened. If the SAP was 
not opened, try again, but be warned that memory is low. 

The procedure NOPREMPT is called when entering OPEN_STATUS_SAP 
to suppress task preemption. OPEN_STATUS_SAP is exited in a 
non-preemptable state and will require the caller to make a call to the 
procedure OKPREMPT if preemptability is so desired. 

Global data modified: 

software_status_sap_ table 
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PCOPY 

This procedure physically copies a message to a new buffer chain, and releases the old 
set of buffers. Data is compact in the new buffers; the first (n-1) buffers are full, and 
the last one has all of its empty space in the trailing portion of the buffer. 

Comdeck CMXPCPY 



Format 
Input 



Output 



Remarks 



PCOPY (message, threshold, success) 

message: buf_ptr 

This parameter indicates the address of the message to be copied. 

threshold: threshold _ size 

This parameter indicates the priority for obtaining buffers. 

message: buf_ptr 

This parameter returns the address of the copied message. 

success: boolean 

This parameter is TRUE if a new buffer chain was successfully obtained 
and FALSE if a new buffer chain is not currently available. 

This time-consuming operation requires at least 3-5 microseconds per byte 
copied. It is recommended that the caller either run at a relatively low 
task priority, or yield control sometime after the routine returns to avoid 
time slice overrun, and to permit other processes to be active. 
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PICK 

This procedure removes a structure from the specified tree, according to the key 
provided, and returns the associated data entry, or NIL (if no matching entry is found). 

Comdeck CMXPPIC 

Format address := PICK (head, key) 

input head: "root 

This parameter indicates the root of the tree to be picked from. 

key: integer 

This parameter indicates the key of the node to be picked from the tree. 

Output address: "cell 

This parameter returns the address of the structure associated with the 
key. 
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PMP_ GET _ DATE 

This procedure returns the current date in the specified format. 

Comdeck PMXGDAT 

Format PMP _ GET _ DATE (format, date, date_str_len) 

input format: ost$date_ formats 

This parameter specifies the format in which the date will be returned. 
Valid specifications are: 



Output 



Specify 



Format 



Example 



osc$month_ date 

osc$mdy_date 

osc$iso_date 

osc$ordinal_date 

osc$dmy_date 

osc$default_date 



month DD, YYYY 

MM/DD/YY 

YYYY-MM-DD 

YYYYDDD 

DD/MM/YY 

Installation 
specified. 



June 21, 1986 

06/21/86 

1986-21-06 

1986172 

21/06/86 



date: ost$date 

This parameter returns the current date. 

date_str_len: 1 .. 18 

This parameter returns the length of the date parameter. 
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PMP_GET_TIME 

The procedure returns the current time of day in the specified format. 

Comdeck PMXGTIM 

Format PMP_GET_TIME (format, time, time_str_len) 

input format: ost$time_ formats 

This parameter specifies the format in which the time will be returned. 



Output 



Valid specifications are: 
Specify Format 



Example 



osc$ampm_ time 

osc$hms_time 

osc$millisecond_ 
time 

osc$default_ time 



HH:MM AM or PM 

HH:MM:SS 

HH:MM:SS:MMM 

Installation 
specified. 



1:15 PM 
13:15:21 
13:15:21:453 



time_str: ost$time 

This parameter returns the current time. 

time_str_len: 1 .. 12 

This parameter returns the length of the time_str parameter. 
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PREFIX 

This procedure adds a header to the front of a message. The header is back filled to 
facilitate insertion of the next header (to be prefixed) in the same buffer. 

Comdeck CMXPPRE 

Format PREFIX (size, address, message, threshold, allocation _ type, success) 

input size: non_ empty _ message _ size 

This parameter indicates the size of the header to be prefixed. 

address: "cell 

This parameter indicates the address of the header to be prefixed. 

message: buf_ptr 

This parameter indicates the message to which the header will be prefixed. 

threshold: threshold. size 

This parameter specifies the buffer threshold to use. 

allocation _ type: pref_type 

This parameter indicates how the buffer allocations are to be performed 
internally by PREFIX. See the description of pref_type in appendix C. 

Output message: buf_ptr 

This parameter returns the message to which the header has been prefixed. 

success: boolean 

This parameter indicates whether the call was successful. 

Remarks If a conditional request is made (i.e. preference type = conditional) and 
that buffer request is not satisfied, then a failure status is returned. 
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PUT_STATUS_RECORD 

This procedure updates the status record for the device name specified. 

Comdeck SDXGPSR 

Format PUT _ STATUS .RECORD (device _ status .record, owner.key, status) 

input device .status .record: component, status .type 

This parameter indicates the status record to be updated. Just the status 
field will be updated via this routine. 

owner .key: A cell 

This parameter indicates the address of the configuration table that was 
provided on the REQUEST_HARDWARE_DEVICE call. 

Output status: boolean 

If the status record was updated, TRUE is returned; FALSE otherwise. 

Remarks Global data modified: 

major_card_status_table 
lim_ status_ table 
port_status_table(s) 
smm_bank_ status, table(s) 
pmm_ bank, status, table 
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QUEUE _IP_COMMAND 

This DVM procedure is used by a stream service routine or TIP to queue commands to 
the DVCB. 

Comdeck DMXQS 

Format QUEUE. IP .COMMAND (dvm_id, ip_cmd_ptr, status) 

input dvm_id: A cell 

This parameter indicates the address of the DVMID. 

ip _ cmd _ ptr: * cim _ cmd _ pkt _ rec _ type 

This parameter indicates the address of the command packet being queued. 

Output status: 0..0ffff(16) 

This parameter returns the status of the QUEUE_IP_ COMMAND call. 
The status codes are: 

0: command accepted. 

1: invalid DVMID supplied. 

2: no command queue entries available (after retrying for 0.5 seconds). 
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READ_BCD_CLOCK 

READ _BCD .CLOCK 

This procedure reads the realtime clock. 
Comdeck CMXMTIM 

Format READ_BCD_CLOCK (the_time) 

input None. 

Output the _ time: "bed _ time 

This parameter returns the time in BCD format, as read from the realtime 
clock. 
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READ CLOCK 



READ_CLOCK 

This procedure reads the binary clock to millisecond accuracy. 

Comdeck CMXMTIM 

Format READ_CLOCK (the_time) 

Input None. 

Output the _ time: integer 

This parameter returns the time, as read from the binary clock. 
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READ_SR0_FROM_IP 

DVM diagnostic services use this procedure to read a status register from an IP. 
Comdeck DMXDIAG 

READ_SR0_FROM_IP (sr, ip_number, reg_number, status) 



Format 
Input 



Output 



ip_number: 0..7 

This parameter indicates the slot number of the IP. 

reg_ number: 0..3 

This parameter indicates the status register number. 

sr: diag_ip_sr_type 

This parameter returns a packed record containing the register value. 

status: 0..0ffff(16) 

This parameter returns the status of READ_SR0_FROM_IP. The status 
codes are: 

0: command accepted. 

1: invalid IP slot number. 

2: IP board is active. 

3: invalid command register number. 

4: bus error received during ICB access. 
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RELEASE_HARDWARE_DEVICE 

RELEASE ..HARDWARE _DE VICE 

This procedure allows the owner of a previously configured hardware device to release, 
or free, the device. It requires its caller to provide the owner's key as an input 
parameter. 

The table address in the associated System Status Table (SST) is set to NIL and the 
hardware device status is set to not_ configured if the following conditions are met: 

• A valid device name is specified 

• The associated board type is physically available in the slot specified by the device 
name 

• The state of the device is not OFF 

• Its status is configured and 

• The owner key matches the configuration address specified on the request. 
SDXAHWD 
RELEASE_HARDWARE_DEVICE (device_name, owner.key, status) 

device_name: string (maximum _ device _ name _ size) 

This parameter indicates the name of the hardware device to be released. 

owner_key: "cell 

This parameter indicates the address of the owner's configuration table 
specified on the REQUEST_HARDWARE_DEVICE call. 

Output status: access_device_status_type 

This parameter indicates whether the device was successfully released. 

Remarks Global data modified: 

major _ card_ status_ table 
port_status_table(s) 



Comdeck 

Format 

Input 
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RELEASE .MESSAGE, FG_RELEASE_MESSAGE 

These procedures release chains of data buffers, with the following effects: 

RELEASE_MESSAGE The buffer(s) are released. 

FG_RELEASE_MESSAGE For interrupt routine use only; the buffer(s) are 

released. 

Comdeck CMXPRLB 

Format RELEASE _ MESSAGE (message) 

FG_RELEASE_MESSAGE (message) 

input message: buf_ptr 

This parameter indicates the address of the message to be released. 

Output message: buf_ptr 

This parameter returns NIL. 
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REQUEST_DIAGNOSTIC_ENTRY 

This procedure obtains the address of the SST entry for the specified device. If a valid 
device name is specified and the associated board type is physically available, then the 
address of the associated SST is returned. 

Comdeck DGXAHWD 

Format REQUEST_DIAGNOSTIC_ENTRY (device_name, kind _ of _ status, 

table, system_status_table_ptr, status) 

input device_name: string (maximum_device_name_size) 

This parameter indicates the name of the hardware device whose SST 
entry is being requested. 

Output kind_of_status_table: system _ status _ table _ type 

This parameter returns the type of SST the system_status_table_ptr 
points to. 

system _ status _ table _ ptn *cell 

This parameter returns the address of the SST associated with the 
specified device. 

status: boolean 

This parameter indicates if the address of the named device's status table 
was returned (TRUE); FALSE if the named device is not available in the 
DI. 
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REQUE ST _ HARDWARE _DE VICE 

This procedure configures the specified hardware device. The parameters for the request 
routine identify the device being requested and provide an owner's key to be associated 
with the device while it is owned by the caller. 

If the following conditions are met, then the caller's configuration table address is 
placed in the associated SST and the device status is set to configured: 

A valid device name is specified 

The associated board type is physically available in the slot specified by the device 
name 

The state of the device is ON 

Device status is initially not _ configured 

Comdeck SDXAHWD 



Format 



Input 



Output 



Remarks 



REQUEST .HARDWARE .DEVICE (device_name, port_owner, cnfg_ 
table _ptr, status) 

device_name: string (maximum_device_name_size) 

This parameter indicates the name of the hardware device to be configured. 

port _ owner: port _ owner _ type 

This parameter indicates the port owner type. This parameter is only 
required when a port is requested; if a device other than a port is 
requested, this parameter can be ignored. 

cnfg_ table _ptn "cell 

This parameter indicates the address of the caller's configuration table. 

status: access _ device _ status _ type 

This parameter indicates if the device was successfully configured. If the 
device was not configured, this parameter identifies the reason why. 

Global data modified: 

major _card_ status_ table 
port_ status_ table(s) 
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RESET_DI 

This procedure resets the DI. 

Comdeck CMXRDI 

Format RESET_DI (software _ reset _code) 

input software _reset_ code: integer 

This parameter indicates the software error that forced the reset. Refer to 
appendix G. 

Output None. 
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RESET_RECOVERY_PROCEDURE 

This procedure removes the specified recovery procedure from the recovery stack. It is 
used at the exit of any procedure that calls SET_RECOVERY_PROCEDURE. 

Comdeck CMISISA 

Format RESET_RECOVERY_PROCEDURE (procedure .address) 

input procedure _ address: "procedure 

This parameter indicates the pointer to the local recovery procedure. 

Output None. 



10-114 Base System Software Revision A 



RESTART PORT SERVICE 



RESTART_PORT_SERVICE 

DVM users use this procedure to restart service for a particular port after reload of a 
peripheral board. 

Comdeck DMXXPS 

Format RESTART_PORT_SERVICE (sps_parm_ptr, dvm_id, status) 

Input sps_parm_ptr: "sps_parm_type 

This parameter indicates the address of the START_PORT_ SERVICE 
parameter block. 

dvm_id: "cell 

This parameter indicates the address of the specified DVMID. 

Output status: O..Offff(16) 

This parameter returns the status of RESTART_PORT_ SERVICE. The 
status codes are: 

0: command accepted. 

1: invalid peripheral board slot specified. 

2: device service not started for specified peripheral board. 

3: service already started for requested port. 

4: invalid DVMID supplied. 

5: board reload is in progress. 
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RESTORE _DVM .INTERRUPT 

DVM diagnostic services use this procedure to change the new interrupt routine to the 
original interrupt routine specified before CHANGE _DVM_ INTERRUPT executed. 

Comdeck DMXDIAG 

Format RESTORE. DVM .INTERRUPT (ip_number, status) 

input ip_number: 0..upper_ip_num 

This parameter indicates the slot number of the IP. 

Output status: 0..0ffff(16) 

This parameter returns the status of RESTORE_DVM_INTERRUPT. The 
status codes are: 

0: command accepted. 

1: invalid peripheral slot number. 
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RESTORE _TASK 

This procedure restores a task from a suspended state that it entered either with 
SUSPEND or ABORT_TASK. 

Comdeck CMXMTSK 

Format RESTORE _TASK (task_id, status) 

Input task _ id: task_ptr 

This parameter indicates the address of the task to be restored. 

Output status: boolean 

This parameter indicates whether the task was restored. 
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SEND_CR0_TO_IP 

DVM Diagnostic Services use- this procedure to send a command register to a 
peripheral. It will not execute when START_DEVICE_SERVICE is active for the 
peripheral board. 

Comdeck DMXDIAG 

Format SEND_CR0_TO_IP (cr, ip_number, reg_number, status) 

Input en diag_ip_cr_type 

This parameter specifies a packed record containing the command register. 

ip .number: 0..7 

This parameter indicates the slot number of the peripheral board. 

reg_number: 0..3 This parameter indicates the command register number. 

Output status: 0..0ffff(16) 

This parameter returns the status of SEND_CR0_TO_IP. The status codes 
are: 

0: command accepted. 

1: invalid peripheral board slot number. 

2: peripheral board is active. 

3: invalid command register number. 

4: bus error received during ICB access. 
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SEND .EXPRESS, FG_TO .EXPRESS 

These procedures send ITMs to express queues in first-in, first-out (FIFO) order. If the 
task is waiting for a message on this queue, the message is copied directly to the 
waiting task's data space. These calls have the following effects: 



SEND_EXPRESS 
FG_TO_EXPRESS 



Comdeck 
Format 

Input 



Output 



Message is sent to target task. 

For interrupt routine use only; message is sent to 
target task. 



CMXMTSK 



SEND _ EXPRESS (size, message, target, status) 
FG_TO_EXPRESS (size, message, target, status) 

size: 1 .. 32767 

This parameter indicates the size of the message to be sent. 

message: "cell 

This parameter indicates the address of the ITM to be sent. 

target: task_ptr 

This parameter indicates the address of the task to which the ITM is to be 
sent. 

status: boolean 

This parameter returns TRUE if the ITM was sent; FALSE if the target 
task address was invalid. 
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SEND .NORMAL, FG_TO .NORMAL 

These procedures send ITMs to normal queues. If the task is waiting for a message on 
this queue, the message is copied directly to the waiting task's data space. These calls 
have the following effects: 



SEND_NORMAL 
FG_TO_ NORMAL 



Comdeck 
Format 

Input 



Output 



Message is sent to target task. 

For interrupt routine use only; message is sent to 
target task. 



CMXMTSK 



SEND _ NORMAL (size, message, target, status) 
FG_TO_NORMAL (size, message, target, status) 

size: 1 .. 32767 

This parameter indicates the size of the message to be sent. 

message: "cell 

This parameter indicates the address of the ITM to be sent. 

target: task_ptr 

This parameter indicates the address of the task to which the ITM is to be 
sent. 

status: boolean 

This parameter returns TRUE if the ITM was sent; FALSE if the target 
task address was invalid. 



10-120 Base System Software 



Revision A 



SET BCD CLOCK 



SET_BCD_CLOCK 

This procedure sets the realtime clock to the specified time. 

Comdeck CMXMTIM 

Format SET _ BCD .CLOCK (the_time) 

input the _ time: "bed _ time 

This parameter indicates the time of day in BCD format. 

Output None. 
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SET_BUFFER_CHAIN_OWNER 

This procedure places an owner identification into the executive allocation field of each 
descriptor and data buffer in the buffer chain. This is provided so memory and buffer 
audit may be accomplished meaningfully. 

Comdeck CSXSBCO 

Format SET_BUFFER_CHAIN_OWNER (buffer .address, owner_id) 

Input buffer _ address: buf_ptr 

This parameter indicates the buffer chain whose ownership is to be set. 

owner_id: memory_owner_type 

This parameter indicates the buffer chain owner. 

Output None. 



10-122 Base System Software Revision A 



SET_MEMORY_OWNER 

SET_MEMORY_OWNER 

This procedure sets an owner identification into the allocator id field of the header of 
the specified memory location. 

Comdeck CSXSMO 

Format SET _ MEMORY. OWNER (memory .address, owner_id) 

input memory .address: "cell 

This parameter indicates the memory location whose ownership is to be 

set. 

owner, id: memory, owner .type 

This parameter indicates the memory location owner. 

Output None. 
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SET_RECOVERY_PROCEDURE 

This procedure pushes the specified recovery block onto the recovery stack of the 
calling task. 

Comdeck CMISISA 

Format SET_RECOVERY_PROCEDURE (recovery _ block, procedure, 

address) 

input recovery _ block: sat$recovery_ block 

This parameter indicates the empty recovery block to be pushed onto the 
task's recovery stack. 

procedure _ address: "procedure 

This parameter indicates the caller's recovery routine. 

Output recovery _ block: sat$recovery_ block 

This parameter returns the initialized recovery block that has been pushed 
onto the task's recovery stack. 
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SET _ WRITE _ PROTE CT 

This procedure sets the write protect flag. The proper use of this routine is in 
conjunction with CLEAR. WRITE_PROTECT. Refer to CLEAR_WRITE_PROTECT for 
more information. 

Comdeck CMISWP 

Format SET _ WRITE .PROTECT 

Input None. 

Output None. 



Revision A Procedures and Functions 10-125 



SFIND 



SFIND 

This procedure finds and returns the table in a tree structure that is associated with 
the specified ASCII key. 

Comdeck CMXPFIN 

Format address := SFIND (head, key) 

input head: "root 

This parameter indicates the root address of the tree table access structure 
to be searched. 

key: "string (*) 

This parameter indicates the key to be searched for. 

Output address: * cell 

This parameter returns the address of the table associated with the 
provided key. If no such table is found, NIL is returned. 

Remarks See GROW. 
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SFIND_FIRST 

This procedure visits each node of the specified string keyed tree structure in 
left-node-right order and calls the user-supplied procedure. The search continues until 
the user-supplied procedure returns a value of TRUE in the field, bool. See also 
SFIND_NEXT, FIND_FIRST, and FIND_NEXT. 

Comdeck CMXPFNF 

Format table = SFIND_ FIRST (head, key, qual, param) 

Input head: "root 

This parameter indicates the address of the head root of the tree structure 
to be searched. 

qual: "procedure 

This parameter indicates the address of the test function to be called. If 
NIL, then SFIND_FIRST will return the smallest key in the tree 
structure. Refer to appendix D. 

param: "cell 

This parameter indicates the parameter to pass to qual. 

Output key: "string (*) 

This parameter returns the smallest key, associated with a table entry, 
that satisfies the procedure qual. 

table: "cell 

This parameter returns the entry in the tree associated with the first key 
that has satisfied the procedure qual. 
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SFIND_NEXT 

This procedure searches the specified string tree structure in left-node-right order for a 
node that contains a key greater than the input parameter, key. For each node that 
satisfies this condition, SFIND_NEXT calls the user-supplied procedure. The search 
continues until the user-supplied procedure returns a value of TRUE in the field, bool 
See also SFIND_FIRST, FIND_FIRST, and FIND_NEXT. 

Comdeck CMXPFNX 

Format table = SFIND _ NEXT (head, key, qual, param) 

input head: "root 

This parameter indicates the root of the tree structure to be searched. 

key: * string (*) 

This parameter indicates the key to be searched for. 

qual: "procedure 

This parameter indicates the address of the test function to be called. If 
NIL, then SFIND_FIRST will return the key that is the next largest 
compared with the input parameter key. Refer to appendix D. 

param: "cell 

This parameter indicates the parameter to pass to qual. 
Output key: "string (*) 

This parameter returns the first key that satisfies the procedure qual. 
table: "cell 

This parameter returns the entry in the tree associated with the first key 
that has satisfied the procedure. 
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SFIND_WILD_CARDS 

This procedure locates wild card matches in string-keyed tree structures and terminates 
when all nodes have been processed or when the user supplied routine returns a value 
of TRUE in the quit_processing parameter. 

Comdeck CSXPFWC 

Format SFIND_WILD_CARDS (head, key, process. match, params) 

Input head: "root 

This parameter indicates the pointer to root of the tree. 

key: "string (* < = max _ name _ size) 

This parameter indicates the pointer to wild card key. 

process _ match: "procedure 

This parameter indicates the supplied routine. Refer to appendix D. 

params: "cell 

This parameter indicates the pointer to parameter list. 

Output None. 
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SGROW 

This procedure adds a new table to the specified string-keyed tree structure. If an 
association already exists between the provided key and a table structure, the 
associated table is returned and no update is performed. Otherwise, the association is 
created, and NIL is returned. 



Comdeck 

Format 

Input 



Output 



Remarks 



CMXPGRO 

address := SGROW (head, key, table, size) 

head: "root 

This parameter indicates the root of the tree to be added on to. 
key: "string (*) 

This parameter indicates the key to be associated with the new table for 
searching operations. 

table: "cell 

This parameter indicates the table to be added to the tree. 

size: integer 

This parameter indicates the size of the table to be added, in bytes. 

address: "cell 

This parameter returns the location of the table in the tree table access 
structure. 

See GROW. 
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SIGNAL(n)/ACQUIRE(n) 

These inline procedures test for, and set, semaphores, permitting multiple processor 
acquisition of data structures in a controlled manner. Multiple semaphores can be 
acquired at once; however, if the Executive fails to acquire one or more of the 
semaphores, then none of the semaphores are acquired. 

Resources must be acquired in this manner, but may be released simply by storing a 
zero in the address specified on the ACQUIRE/SIGNAL call. The executive clears the 
entire byte when it releases the resources. 

These calls have the following effects: 

SIGNAL(n) The resources are acquired, or a failure is returned. 



ACQUIRE(n) 



Control returns when the resource list is entirely 
acquired. 



Comdeck 
Format 

Input 
Output 

Remarks 



CMXMTSK 



SIGNAL(n) (address(n), status) 
ACQUIRE(n) (address(n), status) 
where n is an integer in the range 1..4. 

address(n): "cell 

This parameter indicates the address to be tested for semaphore, or set. 

status: boolean 

This parameter returns an indication of whether the call completed 
successfully. 

If an ACQUIRE(n) request is used by a non-preemptible task and the 
resource is not available, the entire system is halted. 
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SPICK 

This procedure removes a structure from the specified string-keyed tree and returns the 
associated data entry, or NIL. 

Comdeck CMXPPIC 

Format address: = SPICK (head, key) 

input head: "root 

This parameter indicates the root of the source tree. 

key: "string (*) 

This parameter indicates the key associated with the structure to be picked 
from the tree. 

Output address: "cell 

This parameter returns the table associated with the specified key in the 
specified tree structure. 
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START_DEVICE .SERVICE 

This procedure initializes a peripheral board. The CIM Monitor Command Processor 
allocates and initializes a DVCB specific to the peripheral, and boots the peripheral 
into operation. 

Comdeck DMXXDS 

Format START .DEVICE .SERVICE (sds_parm_ptr, status) 

Input sds_parm_ptr: *sds_parm_type 

This parameter indicates the address of the START_DEVICE_SERVICE 
parameter block. This record specifies the peripheral board slot number, 
number of parts, number of buffers, status and command queue sizes, and 
address and length of the module to be loaded. 

Output status: 0..0ffff(16) 

This parameter returns the status of START_ DEVICE .SERVICE call. The 
status codes are: 

0: command accepted. 

1: invalid peripheral board slot was specified. 

2: service has already been started for the specified peripheral. 

3: no SMM memory is available for the DVCB. 

4: peripheral is not available, or is busy. 

5: unable to notify peripheral of DVCB location. 

6: unable to move code block for peripheral. 

7: unable to cause peripheral to execute. 
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START_NAMED_TASK_AND_DELAY 



Given an 
module(s) 

Comdeck 
Format 

Input 
Output 



Remarks 



entry point name, this procedure starts the appropriate task, loading the 
first, if necessary. The caller waits while the request is processed. 

DLXSNTK 

START.NAMED.TASK.AND.DELAY (entry _ point. name, task, 
started, task_id, error .response) 

entry .point _ name: pmt$program _ name 

This parameter indicates the entry point name of the task to be started. 

task .started: boolean 

This parameter returns an indication of whether the task was started. 

task .id: task.ptr 

This parameter returns the task id of the started task. 

error .response: clt$status 

This parameter returns any error messages generated by the Online 
Loader. 

The module use count is incremented to prevent module deloading. 

If the parameter task. started is returned FALSE, it is the user's 
responsibility to release the buffer chain returned in error, 
response.condition. 
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START _ NAMED _TASK__ AND _ PROCEED 



Given an 
module(s) 
loading. 

Comdeck 
Format 

Input 



Output 
Remarks 



entry point name, this procedure starts the appropriate task, loading the 
first, if necessary. The calling task is allowed to continue work during 

DLXSNTK 

START_NAMED_TASK_AND_PROCEED (entry. point. name, 
reply .procedure, request_id) 

entry_point_name: pmt$program_name 

This parameter indicates the entry point name of the task to be started. 

reply .procedure: "procedure 

This parameter indicates the address of a procedure that returns 
information about the module to the original calling procedure. Refer to 
appendix D. 

request.id: "cell 

This parameter indicates the address of an identifier. If the calling 
procedure is making more than one request for the module, this identifies 
the request. 

None. 

The module use count is incremented to prevent module deloading. 

This procedure makes use of a reply procedure to capture returned 
information while processing continues. 

If the parameter task. started is returned FALSE, it is the user's 
responsibility to release the buffer chain returned in error, 
response.condition. 
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START. PORT .SERVICE 

This DVM procedure establishes service to a particular port. It allocates and initializes 
the port control block (DVMID) specific to the LIM port. 

Comdeck DMXXPS 



Format 
Input 



Output 



START _ PORT .SERVICE (sps_parm_ptr, dvm_id, status) 

sps_parm_ptr: *sps_parm_type 

This parameter indicates the address of the START_PORT_ SERVICE 
parameter block. This record specifies the LIM port number, slot number of 
the board, and the address of the DVM user. 

dvm_id: "cell 

This parameter returns the address of the DVMID specific to the LIM port. 

status: 0..0ffff(16) 

This parameter returns the status of START_PORT_SERVICE. The status 
codes are: 

0: command accepted. 

1: invalid peripheral board slot number specified. 

2: device service not started for specified peripheral. 

3: service already started for specified port. 

4: no SMM memory available for DVMID block. 

5: invalid DVMID supplied (DVM software problem). 
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START _ SYSTEM _TASK 

This procedure starts a task with the system ancestor as its parent. A reply procedure 
is used to communicate with the caller. 

Comdeck CMXSISA 

Format START_SYSTEM_TASK (transfer .address, priority, stack_size, 

reply .procedure, request_id) 

Input transfer .address: "procedure 

This parameter indicates the task entry point of the task to be started. 

priority: priorities 

This parameter indicates task priority of the task to be started. 

stack, size: stack .size 

This parameter indicates the stack size of the system task to be started. 

reply _ procedure: "procedure 

This parameter provides procedure linkage. Refer to appendix D. 

request.id: "cell 

This parameter indicates the user request identifier to link request and 
response. 

Output None. 

Remarks The supplied reply procedure should have minimal functionality since it 
executes under the system ancestor task. 

START_NAMED_TASK_AND_DELAY is the recommended procedure to 
call for starting a task. It will look up the entry point and call START_ 
SYSTEM_TASK, which in turn calls MAYBE_TASK. 
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START _TASK 

This procedure starts a task at a procedure entry point. A task that starts another 
task using this call is referred to as a parent task; the new task is referred to as the 
child task. The Executive will send the parent messages with workcodes in the range 
0..15 regarding errant child tasks. Refer to appendix F for explanations of these values. 

Comdeck CMXMTSK 



Format 
Input 



START_TASK (module_ptr, task_attr, lex _ level _ zero _xdcl, task) 

module _ptn dlt$load_id_ptr 

This parameter indicates the pointer to be placed into the TCB for the 

task. 



Output 



Remarks 



task_attr: task .attributes 

This parameter indicates the pointer to the task attributes of the task to 
be started. 

lex _ level _ zero _xdcl: "procedure 

This parameter indicates the address of the entry point to the task 
procedure. 

task: task_ptr 

This parameter returns the task id of the started task. 



NOTE 



START_NAMED_TASK_AND_ DELAY is the recommended procedure to 
call for starting a task. It will look up the entry point and call START_ 
SYSTEM_TASK, which in turn calls MAYBE_TASK. 
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STOP_DEVICE_SERVICE 



STOP_DE VICE .SERVICE 

This DVM procedure stops execution of a particular intelligent peripheral. The CIM 
Monitor Command Processor disables the line to the peripheral and then deallocates 
(releases) the DVCB specific to the peripheral. 

Comdeck DMXXDS 

Format STOP_DEVICE_SERVICE (qds_parm_ptr, status) 

input qds_parm_ptr: *qds_parm_type 

This parameter indicates the address of the QUIT_ DEVICE .SERVICE 
parameter block. This record specifies the slot number assigned to the 
particular peripheral board. 

Output status: .. 0ffff(16) 

This parameter returns the status of STOP_DEVICE_SERVICE. The 
status codes are: 

0: command accepted. 

1: invalid peripheral board slot number has been specified. 

2: service has not been started for the specified peripheral board. 
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STOP_PORT_SERVICE 

STOP _PORT_SERVICE 

This procedure stops service for a particular port used by stream service routines or 
TIPs. It deallocates the port control block (DVMID) specific to the LIM port. 

Comdeck DMXXPS 

Format STOP_PORT_SERVICE (qps_parm_ptr, status) 

input qps_parm_ptn qps_parm_type 

This parameter indicates the address of the DVMID specific to the LIM 
port. 

Output status: 0..0ffff(16) 

This parameter returns the status of STOP_PORT_SERVICE. The status 
codes are: 

0: command accepted. 

1: invalid DVMID supplied. 



10-140 Base System Software Revision A 



STOP TASK 



STOP_TASK 

This procedure stops a task and permanently removes it from the system. 

Comdeck CMXMTSK 

Format STOP.TASK (task, status) 

input task: task_ptr 

This parameter indicates the task to be stopped. 

Output status: boolean 

This parameter returns an indication of whether the call was successful. 

Remarks The module use count for the specified task is decremented. 
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STRIP 



STRIP 

This procedure removes a header from the front of the specified message. 

STRIP differs from STRIP _ IN _ PLACE in that the passed user space is always used 
and no attempt is made to not move the stripped header space (in other words, data is 
always moved). STRIP_IN_PLACE calls STRIP if data movement is required. 

Comdeck CMXPSTR 

Format STRIP (hdr_size, address, msg, threshold) 

input hdr_size: non_ empty _ message _ size 

This parameter indicates the size of the header to be stripped. 

address: "cell 

This parameter indicates the location for movement of stripped space. 

msg: buf_ptr 

This parameter indicates the message whose header is to be stripped. 

threshold: threshold _ size 

This parameter specifies the threshold for buffer acquisition. 

Output msg: buf_ptr 

This parameter returns the message whose header has been stripped. 
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STRIP_IN_PLACE 

STRIP_IN_PLACE 

This procedure returns the header address (without moving it, if possible) and logically 
removes the header from the message. If the header is contained in one buffer, is not 
multiply used, and begins on an even byte boundary, the header address is returned 
and the offset is changed to remove the header. Otherwise, STRIP is called to move 
the header to the user's area. 

Comdeck CMXPSIP 

Format STRIP_IN_PLACE (hdr_size, address, table, message, threshold) 

input hdr_size: non_ empty _ message _ size 

This parameter indicates the size of the header to be stripped. 

address: "cell 

This parameter indicates the location for movement of stripped space if 
STRIP must be called. 

message: buf_ptr 

This parameter indicates the message whose header is to be stripped. 

threshold: threshold. size 

This parameter specifies the threshold for buffer acquisition. 

Output table: "cell 

This parameter returns a pointer to the stripped data, on an even byte 
boundary. 

message: buf_ptr 

This parameter points to the message whose header has been stripped. 
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SUBFIELD 

This procedure obtains multiple-byte header field(s) and copies them to the specified 
text area. 

Comdeck CMXPSUB 

Format SUBFIELD (displacement, length, text, message) 

Input displacement: message. size 

This parameter indicates an offset within the message from which to begin 
copying data. 

length: non_empty_message_size 

This parameter indicates the number of bytes in the subfield. 

text: "cell 

This parameter indicates the address that the subfield is copied to. 

message: buf_ptr 

This parameter indicates the address of the message to copy from. 

Output length: non_ empty _ message _ size 

This parameter returns the number of bytes in subfield. 

Remarks The message parameter may not be equal to NIL. It must be a valid 
descriptor buffer address. 
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SUSPEND 

SUSPEND 

This procedure suspends a task without notifying the parent task. SUSPEND is similar 
to ABORT_TASK, and is restored with the same call, but is intended for use by 
another task that wishes to take matters into its own hands. 

Comdeck CMXMTSK 

Format SUSPEND (task, status) 

input task: task_ptr 

This parameter indicates the task to be suspended. 
Output status: boolean 

This parameter indicates whether the call was successful. 
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TIME 



TIME 

This procedure converts time_of_day or intervals to milliseconds. For example, the 
time 1:53:22 PM is input as (13,53,22); an interval of 10 seconds is input as (0,0,10). 

Comdeck CMXMTIM 

Format mil_time := TIME (hour, minute, second) 

input hour: .. 24 

This parameter indicates the time-of-day or interval hours. 

minute: .. 59 

This parameter indicates the time-of-day or interval minutes. 

second: .. 59 

This parameter indicates the time-of-day or interval seconds. 
Output mil _ time: milliseconds 

This parameter returns the time-of-day or interval expressed in 
milliseconds since midnight. 

Remarks Midnight is input either as (0,0,0) or (24,0,0). 
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TRANSLATE_MESSAGE 

TRANSLATE _ MESSAGE 

This procedure is used for character set translation, such as EBCDIC to ASCII, or 
ASCII to Baudot. The translation table provides a mapping of the 'from' character set 
to the 'to' character set. 

Comdeck CMXPTRA 

Format TRANSLATE .MESSAGE (message, table, threshold) 

Input message: buf_ptr 

This parameter indicates the message to be translated. 

table: string (256) 

This parameter indicates the translation table. 

threshold: threshold. size 

This parameter indicates the buffer allocation threshold. 

Output message: buf_ptr 

This parameter returns the translated message. 

Remarks The addresses for message and table must be valid. The table parameter 
will normally specify a read-only static data structure. 

This is a highly time consuming operation, requiring a minimum of 5 
microseconds per character translated. It is recommended that the caller 
yield control sometime after returning to avoid time slice overrun. 
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TRIM 



TRIM 

This procedure trims the specified number of bytes from the end of the message. Any 
buffers emptied as a result are returned to the free buffer pool. If the entire message 
is less than the requested size, the caller is informed that there are not enough bytes 
to satisfy the request and DEAD_STOP is called. 

Comdeck CMXPTRI 

Format TRIM (size, address, message, threshold) 

Input size: non_ empty _ message _ size 

This parameter indicates the number of bytes needed. If size is NULL, 
nothing is done and the return is immediate. 

address: "cell 

This parameter specifies where to position the bytes that are retrieved. 

message: buf_ptr 

This parameter indicates the message to be trimmed. 

threshold: threshold. size 

This parameter specifies the threshold for buffer acquisition. 

Output message: buf_ptr 

This parameter returns the first data descriptor. 
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UNUSED _ STACK _ 

This function returns the number of reserved user stack bytes that have not been used 
since the specified task was first started. 

Comdeck CMXMTSK 

Format size:= UNUSED_STACK_ (task_id) 

input task _ id: task_ptr 

This parameter indicates the task whose user stack area is to be checked. 

Output size: integer 

The return indicates the number of reserved user stack bytes that have not 
been used since the specified task was first started. 

Zero is returned if the amount of unused space has not changed since the 
last check was made. This response can be used to detect a new minimum 
stack area. The minimum unused stack space is maintained in the task 
control block (TCB) at TCBSPACE. 

A negative response is returned for any of the following conditions: 

• The indicated stack has overflowed its reserved stack area. 

• The task_id is not a valid task pointer. 

• The task_id is NIL and there is no running task. 

A negative response indicates an illogical software condition that requires 
action from the caller to recover or abort the task. The TASK_ 
OVERFLOWED field in the system configuration table will contain a 
pointer to the task that returned the negative response. 
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VALIDATE_SECTION_ADDRESS 



VALIDATE. SECTION _ ADDRESS 

This procedure translates a given address into a module name and a section address 
with offset. If the specified range is not found, or the address is invalid for the MPB, 
the output parameter valid_ section is set to FALSE. 



Comdeck 
Format 

Input 
Output 



DLXVSA 

VALIDATE.SECTION.ADDRESS (address, valid .section, module 
name, section .address, offset) ~ 

address: "cell 

This parameter indicates the address to be translated. 
valid .section: boolean 

This parameter returns an indication of whether the address to be 
translated is valid for the MPB. 

module.name: pmt$program_name 

This parameter returns the associated module name of the user-specified 
address. 

section .address: Midsection 

This parameter returns the associated section address of the user-specified 
address. 

offset- Ut$section_ offset 

This parameter returns the associated offset-within-section of the 
user-specified address. 
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VISIT_ALL_NODES 

This procedure steps through a tree one node at a time, allowing the caller to process 
information at each node using a user supplied routine. 

The user supplied routine has three parameters: a pointer to the first associated table, 
a pointer to cell (user parameters to be passed through to the process routine), and a 
boolean value. Stepping through the tree will continue until all elements in the tree 
have been exhausted or the boolean value returned in the user supplied routine is 
FALSE. 



Comdeck 

Format 

Input 



Output 
Remarks 



CMXPVAL 

VISIT_ALL_NODES (ptr, process, param) 

ptn "node 

This parameter indicates the pointer to current node. 

process: "procedure 

This parameter indicates the user provided procedure. Refer to appendix D. 

param: "cell 

This parameter indicates the pointer to user parameters. 

None. 
WARNING 



User should not modify a tree structure while VISIT_ALL_ NODES is 
executing. 
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WAIT 



WAIT 



This procedure puts the executing task to sleep until a WAKEUP is received for the 
task. This is similar to SEND_MESSAGE, where the message content is void. It could 
be used where a task wishes to wait for an interrupt routine or other task 
accomplishes something before looking at its ITM queues again. 



Comdeck 


CMXMTSK 


Format 


WAIT 


Input 


None. 


Output 


None. 
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WAKE_UP, FG_WAKE_UP 

WAKE_UP, FG_WAKE_UP 

This procedure wakes up a waiting task. If the task has executed a WAIT call, it is 
scheduled. If not, a flag is set indicating that the next WAIT call is to be treated as a 
YIELD. 

These calls have the following effects: 

WAKE_UP The task is awakened. 

FG_WAKE_UP For interrupt routine use only; the task is awakened. 

Comdeck CMXMTSK 

Format WAKE _ UP (task, status) 

FG_WAKE_UP (task, status) 

Input task: task_ptr 

This parameter indicates the task to be awakened. 

Output status: boolean 

This parameter returns an indication of whether the call was successful. 
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YIELD 



YIELD 



This procedure yields control of the CPU by allowing tasks on the same or higher 
priority to execute first; the task that yields is placed at the end of the queue for tasks 
executing at its priority. This is useful for giving up control of the CPU to other tasks. 



Comdeck 


CMXMTSK 


Format 


YIELD 


Input 


None. 


Output 


None. 
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Glossary 



B 

Base System Software 

CDCNET software that works to initialize the device interface and maintain it during 
operation. Base System Software also provides a set of common routines for use by 
other CDCNET software. 

Boot File 

A file that contains the basic set of software that is loaded into a device when the 
device interface requests to be loaded. A boot file brings a device interface up to a 
basic operational state. Further definition of the device interface's functions is provided 
by its system configuration file. 

Bootstrap 

A technique or device designed to bring itself into a desired state by means of its own 
action. For example, a machine routine whose first few instructions are sufficient to 
bring the rest of itself into the computer from an input device. 

Buffer 

One of two structures for the storage of data in device interface memory. Refer to Data 
Buffer and Descriptor Buffer. 



CDCNET 

Refer to Control Data Distributed Communications Network. 

CDCNET Statistics Manager (CSM) 

The CDCNET Statistics Manager provides a bridge between commands that request 
statistics collection and the software that actually collects the statistics. 

CDNA 

Refer to Control Data Network Architecture. 

CIM 

Refer to Communications Interface Module. 

Communications Interface Module (CIM) 

The logic board within a CDCNET device interface that controls transmissions between 
the Line Interface Module (LIM) bus and the internal system bus (ISB). 

Configuration Procurer 

Software that obtains and submits for execution the device interface configuration file 
commands to the Command ME. This is done at system startup. 
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Control Data Distributed Communications Network (CDCNET) 

1. The collection of compatible hardware and software products offered by Control Data 
Corporation to interconnect computer resources into distributed communications 
networks. 

2. A network that is interconnected by Control Data Network Architecture 
(CDNA)-compatible hardware and software products. 

Control Data Network Architecture (CDNA) 

The network architecture designed by Control Data Corporation. CDNA follows the 
lower layer recommendations of the International Standards Organization's (ISO) Open 
System Interconnection (OSI) reference model. 

CRC 

Refer to Cyclic Redundancy Check. 

CSM 

Refer to CDCNET Statistics Manager. 

CYBIL 

Primary implementation language for NOS/VE computer systems and CDCNET 
software. 

Cyclic Redundancy Check (CRC) 

A check code transmitted with blocks of data. This code is used by several protocols. 

D 

Data Buffer 

A structure for storing user data in device interface memory; contrast with descriptor 
buffer. A pointer is associated with the first character of data in the buffer. Data 
buffer length is configurable. 

Data Communications Equipment (DCE) 

The hardware that links data terminating equipment (DTE) to communications media. 
Data communications equipment is normally a modem or modem equivalent (data set). 

Data Terminating Equipment (DTE) 

Data communications equipment that allows human interaction with the databases and 
operations of a network. 

DCE 

Refer to Data Communications Equipment. 

Descriptor Buffer 

A data structure used for chaining data buffers. 

Device Control Block (DVCB) 

The Device Control Block is a data structure that retains information about a device 
interface's intelligent peripheral (IP) boards. Each IP has its own DVCB. 
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Device Identifier (DVMID) First-In/First-Out (FIFO) 



Device Identifier (DVMID) 

A data structure that contains information specific to a port being controlled by an 
intelligent peripheral (IP) board. 

Device Interface (DI) 

The communications processor that Control Data offers as its CDCNET hardware 
product. Also called a CDCNET device interface. 

Device Manager (DVM) 

A set of routines responsible for the interface between CDNA's physical and link layers 
(layers 1 and 2, respectively). 

DI 

Refer to Device Interface. 

DTE 

Refer to Data Terminating Equipment. 

DVCB 

Refer to Device Control Block. 

DVM 

Refer to Device Manager. 

DVMID 

Refer to Device Identifier. 

E 

Ethernet 

A baseband local area network protocol developed by the XEROX Corporation. 
CDCNET supports an Ethernet-compatible network. 

Executive 

A realtime monitor for the device interface which acts as the center of its software 
operating system. The Executive implements a set of procedures that enable users to 
efficiently share the system's available processing power and memory resources. It also 
provides some performance information about its own operation and that of its users. 



Field Replaceable Unit (FRU) 

Any hardware component that is designed for easy replacement on the customer site, 
such as a device interface logic board. 

FIFO 

Refer to First-In/First-Out. 

First-In/First-Out (FIFO) 

This term applies to data processing services in which requests are serviced in the 
same order they are received. 
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FRU ITM 

FRU 

Refer to Field Replaceable Unit. 

G 

Gateway 

A software interface between systems with different architectures and protocols. 

H 

HDLC 

Refer to High-Level Data Link Control. 

High-Level Data Link Control (HDLC) 

The International Standards Organization's (ISO) bit-oriented protocol for the data link 
layer of the Open Systems Interconnection (OSI) reference model. 

Host 

Refer to Host Computer. 

Host Computer 

A mainframe computer system, connected to a communications network, that provides 
primary services such as data base access, user application execution, or program 
compilation. For CDCNET, a host computer provides network support functions, 
including maintenance of device interface load files. 



Internal System Bus (ISB) 

The circuitry within a CDCNET device interface that relays signals between the logic 
boards of the device interface. 

Interrupt Service Routine 

Code within the Executive which services hardware interrupt requests. 

Intertask Message (ITM) 

A means of scheduling work for device interface software routines that relies on a 
queueing service. There are two types of ITM: normal and express. 

ISB 

Refer to Internal System Bus. 

ITM 

Refer to Intertask Message. 
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LIM Online Loader 



LIM 

Refer to Line Interface Module. 

LIM Status Table (LST) 

A data structure that maintains information about any LIM boards installed in the 
eight LIM slots of a DI. 

Line Interface Module (LIM) 

A smaller logic board within a CDCNET device interface that enables the device 
interface to be attached to terminal, workstation, and unit record equipment lines. 

LST 

Refer to LIM Status Table. 

M 

Main Processor Board (MPB) 

The logic board within a CDCNET device interface that provides the primary 
processing power for the device interface. 

Major Card Status Table (MCST) 

A data structure that maintains information regarding any logic boards that have been 
installed in the eight major board slots of the DI. 

Management Data Unit (MDU) 

A generic data structure used within protocol data units for the expression of variable 
data type's. 

MCST 

Refer to Major Card Status Table. 

MDU 

Refer to Management Data Unit. 

MPB 

Refer to Main Processor Board. 

o 

Online Loader 

A CDCNET service that loads software into device interfaces when the software is 
needed while the network is operational, as opposed to initial loader, which loads 
software into device interfaces only when they are started up (initialized). 
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Packet 

A group of binary digits, including data and control elements, switched and transmitted 
as a data unit by communications networks. The packet's data, control signals, and 
error-control information are arranged in a specific format. Different types of networks 
use different sizes of packets. 

Parent Task 

A parent task is a task that calls another task and supplies a recovery procedure for 
the same. If the called task fails, the parent task is notified. 

PBST 

Refer to PMM Bank Status Table. 

PMM 

Refer to Private Memory Module. 

PMM Bank Status Table (PBST) 

A data structure that maintains information regarding the memory banks of the 
Private Memory Module. 

Port Status Table (PST) 

A data structure that maintains information regarding the ports serviced by a Line 
Interface Module (LIM). There is one PST for each LIM that is physically present in a 
DI. 

Private Memory Module (PMM) 

An optional device interface board with 128K bytes of static RAM dedicated to the 
Main Processor Board (MPB) for code execution. 

Programming System Report (PSR) 

An official report to CDC of a problem with CDC software. A PSR can be sent to CDC 
either in hard-copy form or by using the online SOLVER program. 

Protocol 

A set of conventions that must be followed to achieve complete communications 
between the computer-related resources in a network. A protocol can reflect the 
following: 

1. A set of predefined coding sequences, such as the control byte envelopes added to 
(or removed from) data exchanged with a terminal. 

2. A set of data addressing and division methods, such as the block mechanism used 
between a network application program and Network Access Method. 

3. A set of procedures that control communications, such as the supervisory message 
sequences used between a network application program and Network Access. 
Method. 

Protocol Data Unit (PDU) 

A data unit that is used to communicate information between peer entities. 
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PSR Stream Service Routine (SSR) 

PSR 

See Programming System Report. 

PST 

Refer to Port Status Table. 



SAP 

Refer to Service Access Point. 

SBST 

Refer to SMM Bank Status Table. 

SDS 

Refer to Statistics Data Structure. 

Service Access Point (SAP) 

An exchange point between the services of two adjacent Control Data Network 
Architecture (CDNA) layers. 

SMM 

Refer to System Main Memory. 

SMM Bank Status Table 

A data structure that maintains information regarding the memory banks of the 
System Main Memory (SMM) board. 

SOLVER 

An online utility maintained by CDC that contains a database of reported software 
problems and solutions. SOLVER can be used for writing a PSR to report a problem 
with software. 

SSR 

Refer to Stream Service Routine. 

Stack 

An area in memory used as temporary storage for chaining calls during task or 
interrupt service routine execution. Task calls are chained on a user stack. Interrupt 
service routine calls are chained on a supervisor stack. 

Statistics Data Structure (SDS) 

A data structure that is used for the collection and reporting of DI software component 
statistics. 

Stream Service Routine (SSR) 

Software that implements Control Data's Network Architecture layer 2 (the data link 
layer). A stream service routine enables communication over a specific type of network 
solution. 
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Supervisor State X..25 



Supervisor State 

The higher of two privilege levels of CPU operation in a CDCNET DI. Supervisor state 
is used to process Interrupt Service Routines. Contrast with User State. 

System Main Memory (SMM) 

A device interface board with 1024K byte increments of dynamic RAM accessible by all 
interfaces and the resident Main Processor Board (MPB). 

T 

Task 

Any code set within the Executive that is not an Interrupt Service Routine. Each task 
has a unique stack, intertask message queue, and priority. 

Task Control Block (TCB) 

The task control block is a data structure that maintains the context of a task while it 
is executing. 

TCB 

Refer to Task Control Block. 

Terminal Interface Program (TIP) 

CDCNET software that resides in terminal device interfaces and enables 
terminals/workstations that employ specific terminal protocols (such as asyn HASP, 
IBM 2780/3780, and IBM 3270) to communicate in CDCNET networks. 

TIP 

Refer to Terminal Interface Program. 

u 

User State 

The lower of two privilege levels of CPU operation in a CDCNET DI. User state is 
used to process tasks. Contrast with Supervisor State. 



X.25 

The Consultative Committee of International Telephone and Telegraph (CCITT) 
standard for the interface between data terminal equipment and data communications 
equipment in an X.25 packet switching network. 
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Buffers 

Following are the definitions of descriptor and data buffers (also known as small and 
large buffers, respectively). Descriptor buffers are linked by the next_ descriptor field 
and chains of buffers are linked by the next_ message field. 

Comdeck CMDTBUF 

Format VAR name: BUF_PTR 

CYBIL definition: 

CONST 

max.buffer.size = 2304, 

max_chars_in_buffer = max.buffer.size - 2, 

cr1tical_priority = 0, 

default.sbuff len = 32, 

default.lbufflen =144, 

high.pnonty = 1, 

max.sbufflen = 64, 

max.lbufflen = max.buffer.size, 

medium_priority « 2, 

min.sbufflen = 32, 

min.lbuff len « 64, 

low_prionty = 3, 

memory.overhead = 6, 

lbuff .overhead = memory.overhead* 2, 

self = l; { added to destination.count for broadcast, etc. 

TYPE 
non.empty.message.size = 1 .. 65535, 
niessage.size - .. 65535, 
chars.in.buffer ■ .. max.chars.in.buffer, 
non_empty_buffer = 1 .. max.chars.in.buffer, 
pref.type = (absolute®, conditional®, yield®); { See NOTE, below 

TYPE 

data.descriptor * record { Descriptor Buffer Definition 

next .descriptor: "data.descriptor, { next buffer in msg 
next.message: "data.descriptor, { next msg in queue 
the.data: "data.space.record, { the actual stored data 
decstamp: integer, { millisecond time stamp 

offset: non.empty.buf f er , { distance from the.data to 1st byte 
count.buffer: chars.in.buffer, { # bytes data in buffer 
count.message- message.size, { # bytes data in message (1st buffer only) 
usage.descriptor: .. 32767, { usage count of descriptor 
user.data: data.descriptor_user_data.type, { user defined data 

recend, 

data_space_record = record { Data Buffer Definition 

data.usage: . . 32767, {usage count for data space 

data.text: ARRAY [1. .max_cnars_in_buffer*l] OF CELL, 
recend, 

buffer.request. limit - 1 .. 999, 

executive.extent - 1 .. 32767, { size of executive extent 
buf.ptr « "data.descriptor; 
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Buffers 



The following are definitions of user defined data kept in the 
data.descnptor record. These fields are normally unused since 
the common subroutines request sbuff len (32) bytes for the 
data.descrtptor record. 



TYPE 
data.descriptor.user_data.type = record 
case integer of 

" 1 - { XEROX TRANSPORT 
sequence: .. 0ffff(16), 

« 2 = { TDSM (text .processor) 
text_process_l: "cell, 
text.process.2: "cell, 

= 3 = { TDSM (output.queue) 
marked.output : boolean, 

casend, 
recend; 



Remarks Be aware of what the common subroutines do with buffers; for example, 
buffers may be released when STRIP is called. 

NOTE . 

There are three options defined by the type pref_type. These options are 
used in calls to APPEND, PREFIX, and BUILD_HEADER_IN_PLACE. 
Internally the options have the following meanings when the routine 
obtains data buffers. 

absolute® Uses the sure interface; always returns a successful 

status. 

conditional® Uses the maybe interface; returns the request status 

from the Executive to the user. 

yield® Uses the maybe interface; if successful, returns that 

status to the user. If not, yields and repeats the 
process. 
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DVM Command Packets and Status ITMs 

Following are the CYBIL definitions for device manager (DVM) command packets and 
status intertask messages (ITMs). Refer to chapter 9 for a description of DVM and the 
services it provides. 



,__.....__„ __„=„=== — „.__„____„„ „«„„„«} 

{ CIM COMMAND PACKET RECORD } 

{---------„_._--___„____„__„„.._._-_„___.___„_„„„ == . } 

TYPE 
cim_cmd_pkt_rec_type • record 
code: cc_cmd_range, 

dvm.id: "cell, 

case integer of 

= 100 - { force packet size > 
body: array [A . . 8] of . . 0ffff(16), 

» cc.hb - 
hb.status: cim.f lag.set.type, 

= cc.configure.line, 
cc.reconf igure.line - 
conf ig_info_ptr: "ciiti.conf ig.rec.type, 

- cc.start.input « 

input.flags: cim.flag_set.type, 

input.setup.state: integer, 

• cc.start .output • 

output.f lags: cim.f lag.set .type, 

output.setup.state: integer, 
output.buf.ptr: *data_descnptor, 

• cc.terminate.io » 

term mate.f lags: cim.f lag.set.type, 

■ cc.def ine.user.area * 
user.data.ptr : "c i m.user __ata.rec.type , 

• cc.execute.state - 

state.fiags: cim.f iag.set.type, 
execute.setup.state: integer, 

= cc.lme.setup = 

lim.num: .. upper.l im.num, 

lim_port: .. upper _port_num, 

casend, 
recend; 
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CIM STATUS RESPONSE & ITM RECORD 



TYPE 
cim_status_rec_type = record 
dvm_id: "cell, 

case integer of 

» « { force packet size ) 
stat_pkt_size: array [4 

= sc_card_ok - 
hb.status: cim_f lag_set_type, 



■ sc_line_conf igured, 
sc.line.reconf igured ■ 
conf ig.status: boolean, 

conf ig_info_ptr: "cim.conf igj-ec_type, 

« sc_ line .deleted • 
xflags: cim.f lag_set_type, 

= sc.line.enabled » 
enable.f lags: cim.f lag_set_type, 

■ sc.ime.disabled « 
yfiags: cim_f iag_set_type, 

■ sc_input_received = 
mput.fiags: cim.f lag.set.type, 
input_buf_ptr: "data.descnptor, 

= sc.output.sent = 
output.f lags: cim.f iag_set_type, 
output _buf_ptr: "data.descnptor, 

* sc_io_terminated = 

term inate.f lags: cim_f lag_set_type, 

* sc_user_area_def 1ned = 

user _area_f lags: cim.f lag_set_type, 
user_data_ptr: *cim_user_data_rec_type, 

= sc_state_executed • 
zflags: cim_f lag_set_type, 

r sc_line_disconnect = 
disconnect_f lags: cim.f lag_set_type, 

casend, 
recend; 



TYPE 
cim_stat_1tm_rec_type = record 
status: sc_status_range, 

info: cim_status_rec_type, 

RECEND; 



8] Of .. 0ffff(16). 
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{==-=« -=--_--.-___-__--_„_-_._____________.-„-} 

! DATA TYPE TO DEFINE CMD PKTS TO ESCI VIA DVM } 

{===== - = -=-=----------} 

TYPE 
Ulnt16 = .. 0ffff(16), 

fesci_cind_pkt_type = record case boolean of 
=true= 

feso.cmd.code.type: uint16, 

dvm.id: "cell, 

case . . 255 of 

= cc.strtup * 
config.tbl_ptr.type: ~li.esci_lib.type, 

= cc.xmit = 
xmt.buffer: buf.ptr, 

casend, 
=false= 

cim_cmd: cim_cmd_pict_rec_type, 
casend recend; 



{ __«„«____»_»_.„..„„„.._.__. == __„__„.««_._ = _ === ..; 

{ DATA TYPES TO DEFINE ESCI INTERTASK MESSAGE ) 

{---..=----=-=-..-------.-.---.-----.-.-.----.--..--„.„.=......„} 

TYPE 
esci_state_type = (idle, operational, suspended); 

TYPE 
esci.status.type = (stat.null, stat.up, stat.dwn, 
stat.sus, stat.failed); 

TYPE 

esci_inttsk_msg_type= record 

message.type: uintie, 

case . . 65535 of 
= = 
byte: PACKED ARRAY [0. . 126] Of Char, 

- esci_startup.cmd, esci_shutdown.cmd, esci_suspend.cmd, 
esci.resume.cnid, esci_statistics_cmd, esc i _wakeup_cmd= 
esci_lib_ptr:~esci_l ib.type, 

= esci.nures.res, esci.rcv.res, esci.xmit.res, esci.stistc.res, 
esc i .switches .res, esci_tdr_res, esci.diag.res, esc 1 .nop.res , 
esoi_dump_res. esci.xsub.res = 
dvm.id: "cell, 

case . 65535 of 
- esci.nures.res = 

esc i .status: esci.status.type, 

reason: reason.code.set , 

= esci.rcv.res = 
rcv.status.info: pacKed record 
CASE boolean OF 
= TRUE = 

rcv.status.bi ts : rcv.status.b i ts.set , 
■ FALSE ' 
chk_586: packed record 
frm.stat: 0..0f(16), 
frm.err: 0..3f(16), 
recend, 
CASEND, 
recend, 
rcvd.buffer: ALIGNED buf_ptr, 
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= esci_xmit_res « 

xmt_status_info: packed record 
bc_mc_frame: boolean, 
rsv_stat_1: boolean, 
frame.transmitted: boolean, 
abort.requested: boolean, 

rsv_stat_2: boolean, 
no.carner .sensed- boolean, 
lost_cts: boolean, 
memory_underrun: boolean, 

deferred: boolean, 
heartbeat: boolean, 
too_many_collisions: boolean, 
rsv_stat_3: boolean, 

number_of_colliSions: .. 15, 
recend, 
xmted.buffer: ALIGNED buf _ptr, 

■ esci.stistc.res = 

not_used_stats: uint16, 
orc_errors: uint16, 
aln.errors: uint16, 
rsc.errors: uint16, 
ovr .errors: uint16, 

= esci_switches_res - 
sense_switcr.es: set of (esci_switch_l, esci_s«ntch_2, 
esoi_switch_3, esci_switch_4, esci_switch_5, esci.switch. 
esci_switch_7, esci_switch_8, esci_switch_rsv_l, 
esci_switch_rsv_2, esci_switch_rsv_3, esci_switch_rsv_4, 
esci_switch_rsv_5, esci_switch_rsv_6, esci_switch_rsv_7, 
esci_switch_rsv_8), 

■ esci_tdr_res = 
tdr_result: record 

link.ok: boolean, 

link_not_ok. boolean, 

link.open: boolean, 

link.short: boolean, 

tdr_resv_1: boolean, 

tdrjtime: .. 7ff (16), 
recend, 

= esci_diag_res = 
diagnose_result. record 

diagnose_resv_l: 2 .. 0ffff(16), 

d i agnose_resu it: boo l ean , 
recend, 

= esci.dump.res = 
dump.status: uintl6, 
duitip_buffer: "cell, 

* esci_xsub_res » 
subroutine. Info: "cell, 
casend, 
casend, 
recend, 
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Executive Error Table 

The Executive Error Table is initialized by the system Executive and is located in 
MPB RAM. 

Comdeck CMCERTB 

CYBIL definition. 

CONST 
number.of .error .buffers = 3; { Number of error buffers, minus one 

TYPE 
executive.error.table = record 
stop_supervisor_stack.pointer: "cell, { supervisor stack pointer 1f exec 

{ stop 
last_error .address: "error .buffer, 

locK.last.error: .. 0ffff(l6), { last.error .address being updated 
address_error.be ing_processed: .. Offff(16), 
number .of .spurious. interrupts: .. Offff(16), 
smm .error .count: array! . . 7 ] of . 16), 
total. error .count: .. Offff(16), 
system .ancestor.tcb: task_ptr, 
debug.address.cal led.on.error: "cell, 

error .buffers: arrayt .. number .of .error .buffers ] of error .buffer, 
recend; 

TYPE 
error .buffer « record 
executive.error.code: ex .error .codes, 

lock.error .buffer: .. Offff<16), { non-zero k error buffer 
bine lock.at.time.of .error: integer, 
dO_thru_d7: arrayt .. 7 ] of integer, 
a0_thru_a6: arrayt . . 6 ] of integer, 
status.register: .. Offff (16), 
supervisor _stack_pointer: "cell, 
user_stack_pointer: "cell, 
program.counter : *ce 1 1 , 
tcb.f or.runn mg_task : task_ptr , 
module.name: pmtSprogram.name, 
module.offset: .. Offff(l6), 
error .during.f irewall: .. Offff (16). { if non-zerro then error during 

{ firewall 
f irewall. procedure.address: "ceil, 
mpb.status.register: mpb.status.word, 
case ex.error .codes of 
* bus .error. i, address.error.i * 

f i rs t _f a i 1 ure.capture.address : *ce 1 1 , 

bus.exception.status: .. Offff (16). 

access .address: "cell, 

instruct lon.register: .. Offff (16), 
■ smm.single.bit.error.i, smin.double.bit.error.i ■ 

smm.card.slot: .. 7, 

smm_error.log: .. Offff (16), 
casend 
recend; 

TYPE 
ex .error .codes - ( unused.O. 
unused, l, 
bus .error. i, 
address.error.i, 
i 1 legal.instruct ion.i , 
zero.divide.i, 
chk.instruction.i, 
trapv.instruotion.i , 
pnvilege.violation.i , 
trace.interrupt.i, 
line_1010.mterrupt_i, 
1 me.l 1 1 l.interrupt.i , 
smm.single.bit.error.1 , 
smm_doub1e_bit.error_i , 
task_runs_too_long_i ); 

VAR 
exec.error.table- [XREF] executive.error.table; 
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{ 

{ MPB status register from address 6100(16) in mpb ram 

{ 

CONST 
mpb.status.byte « 6100(16); 

TYPE 

mpb.status.word = packed record 
access.code: type _of .memory, 
access.type: type_of_io, 
dtack.time.out: boolean, 
bus.lock.time.out: boolean, 
panty_error: boolean, 
write.protect: boolean, 
dead.man.time.out: boolean, 
bit.not.used: boolean, 
manual .reset: boolean, 
external. clear- boolean, 
a.c.low. boolean, 
temperature.shutdown •. boolean, 
temperature.warnlng: boolean, 
battery.low: boolean, 
recend; 

TYPE type.of.memory = (pmm.bus, itb_bus, mpb.random , no_bus); 
TYPE type.of.io = (no.io, read.io, wnte.lo, intack.io); 
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MPB RAM Definition 

MPB RAM resides at a fixed address within DI memory. 
Comdeck SIDRAM 

CYBIL definition: 

VAR 

mpb_ram_ptr. [STATIC, READ] "mpb.ratn := NIL, { "MPB.RAM from byte address D 

TYPE 
mpb.ram = packed record { description of mpb ram starting from address 
vector: array [1 . . 256] of "cell, { vector space 
system.id: system. id.type, { unique identifier for this hardware box 
systenTid checksum: .. 0ffff(16), { system.id checksum 
table.format.version: . 0ffff(16), { version of this RAM table format 
status: .. Off (16), { MPB status register low 4 bits (if nmi occurs) 
mpb_ram_zeroed: .. Off (16), { MPB RAM zeroed flag 
smm.size: integer, { # contiguous usable SMM bytes from 100,000(16) 
boot .map.entry .address: "cell, { "map entry used as bootstrap card 
auto.dump.table.address: "cell, { " Auto Dump Table 
reset.status: .. Off (16). ( reset status saved from most current reset 
resetlcode: .. Off (16), { reset code ( from both software and hardware 
software.error.code: .. Off (16), { software error code 
hardware_reset_code: .. Off (16), ( possible hardware cause for reset 
version:"o .. OffffOB), ( version within last accepted help offer 
network.id: integer, { network id within last accepted help offer 
help.system.id: system.id.type, { system id within last accepted help 
auto dump.subroutine .address: "cell, { " Auto Dump Table generator 
auto.dump subroutine length. .. Offff(IB), ( length in 16-bit words 
auto.dump.subroutine.checksum: .. OffffOB), ( 16-bit ones complement 
map.table- ALIGNED array [1 .. 72] of integer, { card map table 
reserved 4 bytes, integer. { reserved for future use 
mpb.error routine_pointer: "cell, ( starting address of MPB error routine 
mpb.error .routine, length: .. OffffOB), < length in 16-bit words 
pmm .error routine pointer: "cell, ( starting address of error routine 
pmm error .rout ine.length: .. 0ffff(16), { length in 16-bit words 
sum error.routine pointer: "cell, ( starting address of error routine 
smm error routine.length: .. OffffOB), ( length in 16-b words 
expected.smm. interrupt .flag: "cell, ( expected SMM interrupt flag pointer 
ept address: ALIGNED "cell, { starting address of the entry point table 
loaded.module.list: "ilt$module.header, { pointer to 1st entry 
unsatisfied.externals: "cell, { " unsatisfied externals table 
desbuflen. integer, { length of descriptor buffers 
datbuflen: ALIGNED integer, { length of data buffers 
reservedjnemory: ALIGNED .. 32767, { reserved memory for critical use 
' initial.loader .checksum- ALIGNED .. 0ffff(16), { 

sys.cnfg.ptr: "cell, { address of executive configuration table 
system ancestor .task. id: ALIGNED task_ptr, ( "system ancestor tcb 
current.3b.ephemeral. sapid: ALIGNED sap.id.type, { next 3b SAP to assign 
recend ; 

CONST 
software.error .address - 41a(16); { "mpb_ram.ptr".software_error_code 
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Queue Control Block 

The queue control block (QCB) structure maintains an intertask message queue for use 
by the task that owns it. It is defined by type qcb@. 

Comdeck CMDTTSK 

Format VAR name: qcb_ptr 

CYBIL definition: 

TYPE 
qcb@ = record 

length: .. 32767, { current length of queue 

count: .. 32767, { number of enqueues that have happened to this QCB 

qnext: buf_ptr, 

qlast: buf.ptr, 

qcharacters: integer, { number of characters in queue 
recend; 



TYPE 



qcb_ptr = "qcb©; 
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System Configuration Table 

The System Configuration Table is a data structure that retains the status of essential 
CDCNET system variables. It is in the form of a record with fields indicating such 
things as the highest address in MPB RAM and the states of memory and buffers. 

Comdeck CMCCNFG 

Format VAR sys_cnfg: [xrefj execconfig 

CYBIL definition: 

VAR 

address. "exec.conf ig, 
table, execconfig; 

TYPE 
exec.conf ig - record 
maxpnor: .. 32767. { highest valid priority -- lowest is zero 
databac: .. 32767, { data buffer available count 
descbac: .. 32767, ( descriptor buffer available count 
lbufflen- integer, { data space length in bytes 
sbufflen: integer, { descriptor buffer length in bytes 
stdstack: integer, { standard stack allocation 
running: task_ptr, { task.ptr of running task 
curprior: priorities, { currently running priority 
schprior: priorities, { highest scheduled priority 
pmtok: boolean, { task preemption permission flag 
vecslice. integer, { interrupt vector for time slice interrupt 
vecmtvl: integer, { interrupt vector for interval timer interrupt 
vecclock: integer, { interrupt vector for millisecond interrupt 
mpbramtop: integer, {numerically largest address in mpb ram 
pnvatetop: integer, { numerically largest address in private memory 
globfree: integer, { number of bytes of free global memory 
locfree: integer, { number of bytes of free private memory 
mpbfree: integer, { number of bytes of free mpb ram memory 
globfrag. . 32767, { number of extents of free global memory 
locfrag: .. 32767, { number of extents of free private memory 
mpbfrag: :. 32767, { number of extents of free mpb ram memory 
deloadtyp: deload.f lag, { type of memory to release flag for deload task 
deloadtcb: task_ptr, < task_ptr of deload task 
deloadmpb- .. Offff (16), { deloadable bytes of mpb ram 
deloadpmm: integer, ( deloadable bytes of private memory 
deloadsmm: integer, { deloadable bytes of global memory 
mpbthresh. .. Offff < 16), { dload threshold for mpb am 
pmmthresh: integer, { deload threshold for private memory 
smmthresh: integer, { deload threshold for global memory 
pmtreq: boolean, { task will yield on next trap 1 or trap 4 if set 
retryflag: .. 32767, { retry in progress flag 
clocktyp: .. 1, { - millisecond clock; 1 - real time c ck 
timertcb: task_ptr, { task_ptr of time task 
diagflag: diagset, ( current debug support tools set 
binclook: integer, { .1 second accuracy binary time of day 
decclock: bcd.time, { .1 second accuracy bed date/time 
assumed.year: .. 32767, {assumed year used by executive 
firewall: integer, { address of interrupt firewall chain 

prilist: array [priorities] of qcb@, { ready lists for tasks scheduled at priorities 
globmem: qcbP, { global memory extent list 
pnvmem: qcb@, { private memory extent list 
mpbmem: qcbS>, { mpb ram memory extent list 
badextnt. qcttf, { bad extent list 
lptlist: qcb@, { defined interrupts list 
lbuffq: qcb®, { data buffer queue 
sbuffq: qcb@, { descriptor buffer queue 
data_buffer .count: .. 32767, { number of data buffers 
descriptor .buffer .count: .. 32767, { number of descriptor buffers 
expire.stp: .. 32767, { expire state transition processor timer 
stack_overf low space: integer, { size of stack overflow area allocated 
task overflowed: taskjrtr, { task_ptr of task which has overflowed its stack 
pc.chkinst.address- integer, { PC where chk instruction executed 
usp.chkinst .address: integer, { USP when chk instruction executed 
npbllight.state: light.status, { status of mpb lights 
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ldle.loop.count: integer, ( executions of idle loop since last clear 

reservetop: integer, { numerically largest address in reserve memory 

rsvfree- integer, { number of bytes of reserve ram memory 

rsvfrag: . . 32767, { number of extents of reserve global memory 

rsvmem: qcb®, { reserve ram memory extent list 

memory.state: memory, state.type, {depends on amount of free memory 

buffer .state: buffer, state.type, {depends on amount of free memory 

stp.timer: "timer, { timer id of state transition processor 

cio.b: cio_port_b, { CIO port B bit settings 

cio.c- ALIGNED cio.port.c, { CIO port C bit settings 

supervisor .state.ok: .. 0ffff(16), { 1 = OK, - user task recend; 

TYPE 
priorities » .. max_prionty, 
stack.size = min.stack.size .. max.stack.size; 

CONST 

max.pnority = 7, 

min.stack.size - 0, 

max.stack.size = 2000(16); 

TYPE 
deload.flag = ( llc$mpb, llcSpmm, llc$smm ); 
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Task Control Block 

The task control block (TCB) structure describes task constants and types for use by 
the Executive. It is defined by type taskid®. 

Comdeck CMDTTSK 

Format VAR name: task_ptr 

CYBIL definition: 

TYPE 
taskid® • packed record { packed to force correct data mappings 

next.task: task_ptr, { chain to next task_ptr 

id- integer, { = ' iTCB' 

stsiz: integer, { size of current stack segment 

chldq: task.ptr, { task.ptr of my next sibling 

adult: task.ptr, { task_ptr of my parent 

child: task_ptr, { task_ptr of my child 

stack- integer, { address of my current stack segment 

state.fi 11: .. 31, 

state: .. 7, { my. current state 

trans ltion.f ill: . . 15, 

trans: . 15, { transition that entered this state 

tran: array [0 . . 15) of . . 65535, { counts of transitions to date 

slices. . 65535, { count of time slice overruns to date 

flag.fill_l: .. 31, 

preempted: boolean, { task has been preempted; registers all saved (else only 
{ A6 and D7) 

hold, boolean, { used by timer task to deflect requests into Normal queue 

wku: boolean, { wakeup pending if set 

flag.fi 11.2: . 255, 

express: qcb@, { inter-task message queue 

normal. qcb§>, { 1nter-task message queue 

preempt .perm it : .. 32768, { zero = task not preemptible; else preemptible 

cpriority: .. 32768, { my nominal priority 

priority. .. 32768, { my actual priority 

d.registers: array [0 . 7] of integer, { only register D7 normally valid 

a.registers: array [0 .. 6] of "cell, { only register A6 normally valid 

usp: 'cell, { user stack pointer 

sr: .. 0ffff(16), { status register 

pc: "cell, { program counter 

tobfrb: *sat$reoovery_block, { pointer to task failure recovery block 

tcb.epa: "cell, { task entry point address 

tcb.space: integer, { amount of unused space in reserved stack area 

tcbmhp: dlt$moduleJieader_ptr, { pointer to module header 

age: .. 0ffff(16), { age within dispatch queue 
recend; 

TYPE 
task_ptr - "taskid©; 
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Following is an alphabetical listing of the CYBIL constants used in the procedures and 
functions defined in chapter 10. 

dbc$single_line = 79 { characters 

dlc$default_ priority = 

dlc$max_ section _ checksum = 0ffff(16) 

dlc$max .section _ offset = 7fffffff(16) 

dlc$max_ section _ ordinal = 0ffff(16) 

dlc$maximum_68000_ address = 7fffffff(16) 

max _buf_ level = 400 

max_cmd_q_size = 200 

max_number_ports = 32 

max _ priority = 7 

max_response_message_id = 65535 

max _ stack _ size = 8192 

max_stat_q_size = 200 

maximum _ device _ name _ size = 11 

mdu_ field _ size = 32000 

min_response_message_id = 33000 

min_ stack _ size = 2048 

osc$max_ name _ size = 31 

rcv_threshold = { buffer and descriptor thresholds 

svm_thresh = { SVM buffer threshold 

upper_ip_num = 7 

upper _lim_num = 7 

upper _ port _num =? 3 
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Common Types 

Following is an alphabetical listing of the CYBIL types used in common by the 
procedures and functions defined in chapter 10. 

access _ device _ status _ type = 

(device_state_not_on, 
device_state_off, 
device_status_not_cnfg, 
device_configured, 
device_not_configurable, 
device_unavailable, 
device _ released, 
invalid_ cnfg_ table_ address , 
device_status_already_cnfg, 
invalid_key) 

access _ status _ type = 

(sap_opened, 
sap_ not_ opened) 

bed = .. 9 

bed _ time = packed record 

lyear: bed, 

ryear: bed, 

lmonth: bed, 

rmonth: bed, 

lday: bed, 

rday: bed, 

lhour: bed, 

rhour: bed, 

lminute: bed, 

rminute: bed, 

lsecond: bed, 

rsecond: bed, 

deci: bed, 

centi: bed, 

milli: bed, 
recend 

buffer _ request _ limit = 1 .. 999 

buffer, state _ type = 

(buffer _ good, 
buffer_fair, 
buffer_poor, 
buffer_congested) 
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card _ info _ record = record 

card_type: hardware_resource_type, 
primary _ address: integer, 
secondary_address: integer, 

recend 

chars _in_ buffer = .. max_chars_in_buffer 



cim _ conflg _ rec _ type 


= packed record 


line_mode: 


0..255, 




char_length: 


0..255, 




stop_bits: 


0..255, 




crc_type: 


0..255, 




crc_preset: 


0..255, 




modem_mode: 


0..255, 




modem_type: 


0..255, 




not_used: 


O..0ffff(16), 


{ place holder 


input_ baud_ rate : 


0..0ffffX16), 


{ bps rate time const 


output_baud_rate: 


0..0ffff(16), 




state_ prg_ indx: 


0..255, 




clock_mode: 


0..255, 




recend 







cim_flag_set_type = set of 0..15 

cim _ user. data _ mask _ type = set of 0..cim_user_data_max 

cim_user_data_max = 79 

cim _ user _ data _ rec _ type = record 

valid_data: cim_user_data_mask_type, 

data: cim_user_data_type, 

recend 

cim _ user _ data _ type = packed arrary [0..cim_user_data_max] of 0..0ff(16) 

close .statistics, status = 

(statistics_sap_closed, 
statistics_sap_entry_not_found, 
mismatch. statistics_sap) 

clt$status = record 
normal: boolean, 

response.id: min_response_message_id .. max_response_message_id, 
condition: buf.ptr, { management data unit syntax 

recend 
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component _ status _ type = record 

name: string (maximum_device_name_size), { Hardware physical device name 

state: device_state_type, { device state 

status: device_status_type, { device status 

recend 

device _ state _ type = 

(device _ on, 
device_off, 
device_down) 

device _ status _ type = 

(de vice _ not_ cnf g, 
device _cnfg, 
device _ enabled, 
device _ active) 

dg_ data _ buffer _ priority = medium_priority { CIM online diagnostic 

diagset = set of diagset® 

diagset@ = 

(unused_15, { unused flag position 
unused_14, { unused flag position 
unused_13, { unused flag position 
unused_12, { unused flag position 
unused_ll, { unused flag position 
unused_10, { unused flag position 
unused_9, { unused flag position 
unused_8, { unused flag position 
diagwrap, { wrap-around journal buffer 
diagpcsr, { log PC and SR on precise CMCSTAT entry 
diagipts, { log spurious interrupts 
diagclc, { perform excess buffer collection 

diagdups, { test for duplicate buffer release 
diagbufs, { log memory allocation/release in journal 
diagevnt, { log task event messages in journal 
diagtask) { log task state changes in journal 

dip_parm_type = record { Dump Intelligent Peripheral 

ip_number: 0..upper_ip_num, { board slot number of device 

dump_ start: A cell, { local RAM address 

dump_length: 0..0ffff(16) { size of RAM to dump 

recend 

display .procedure = 'PROCEDURE 
(sds_hdr_ptr: A sds_header; 
time: report_time_type; 

VAR disp_msg: buf_ptr) 
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dlc$default_immediate_control = FALSE 
dlc$default_preemptibility = FALSE 
dlc$max_section_length = dlc$max_section_ offset 
dlt$ampm_time = string (8) 
dlt$checksum = .. ilc$max_section_ checksum 

{ Date request return value 



dlt$date = packed record 
fill: ..lf(16), 
case date_format: dlt$date_ formats of 
= dlc$month_date = 

month: dlt$month_date, 
= dlc$mdy_date = 

mdy: dlt$mdy_date, 
= dlc$iso_date = 

iso: dlt$iso_date, 
= dlc$ordinal_date = 

ordinal: dlt$ordinal_date, 
= dlc$dmy_date = 

dmy: dlt$dmy_date 
casend, 
recend 

dlt$date_ formats = 

(dlc$default_date, 
dlc$month_date, 
dlc$mdy_date, 
dlc$iso_date, 
dlc$ordinal_date, 
dlc$dmy_date) 



{ month DD, YYYY 
{ MM/DD/YY 
{ YYYY-MM-DD 
{ YYYYDDD 

{ DD/MM/YY 



dlt$dmy_date 



string (8) 

record 



dlt$entry _ description 

node: node_control, 
name: pmt$program_name, 
address: dlt$68000_address, 
module_header_address: *dlt$module_ header, 
link_address: *dlt$entry_ description, 
declaration_ matching_ required: boolean, 
declaration_matching_ value: string (8), 
language: dlt$module_generator, 
recend 

dlt$hms_time = string (8) 

dlt$iso_date = string (10) 
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Common Types 

dlt$load_id_ptr = ilt$module_header_ptr 

dlt$maximum_ modules = .. dlc$max_section_ ordinal 

dlt$mdy_date = string (8) 

dlt$millisecond_time = string (12) 

dlt$module_ attributes = set of (dlc$nonbindable, dlc$nonexecutable) 

dlt$module_ generator = 

(dlc$algol, 
dlc$apl, 
dlc$basic, 
dlc$cobol, 
dlc$assembler, 
dlc$fortran, 

dlc$object_ library _ generator , 
dlc$pascal, 
dlc$cybil, 
dlc$pl_i, 

dlc$unknown_ generator , 
dlc$the_c_language, 
dlc$ada) 

dlt$module_ header = record 

link_address: dlt$module_header_ptr, 

mod_ head: dlt$module_ identification, 

allocated_ sections: array [0..*] of dlt$section_ identification, 
recend 

dlt$module_ header _ptr = "dlt$module_ header 

dlt$module_ identification = record 

name: pmt$program_name, 

kind: dlt$module_kind, 

time_created: dlt$time, 

date_created: dlt$date, 

attributes: dlt$module_ attributes, 

breakpoint_set: boolean, 

retain: boolean, 

member_of_internal_set: boolean, 

use_count: dlt$maximum_ modules, 

reference_list: *dlt$module_reference, 

module _ status: dlt$module_ status, 

entry_address: "dlt$entry_description, 

greatest_section_ordinal: dlt$section_ordinal, 

tr ansfer _ symbol_ address : * dlt$entry _ description, 
recend 
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dlt$module_kind = 

(dlc$mi_virtual_state, 
dlc$ vector _ virtual _ state , 
dlc$iou, 

dlc$motorola_ 68000, 
dlc$p_code, 
dlc$motorola_68000_absolute) 

dIt$module_ reference = record 

link_address: A dlt$module_reference, 

reference_link: *dlt$module_header, 
recend 

dIt$module_ status = 

(dlc$active, 
dlc$deloaded, 
dlc$load_in_progress) 

dlt$month_date = string (18) 

dlt$ordinal_date = string (7) 

dlt$section = array [1..*] of 0..255 

dlt$section_ access _ attribute = 

(dlc$read, 
dlc$write, 
dlc$execute, 
dlc$binding, 
dlc$read_other, 
dlc$write_ other, 
dlc$execute _ other , 
dlc$binding_ other) 

dlt$section_ access _ attributes = set of dlt$section_access_ attribute 

dlt$section_address_range = - (dlc$max_section_ offset + 1) .. 
dlc$max_section_ offset 

dlt$section_ identification = record 
checksum: dlt$checksum, 
length: dlt$section_ length, 
attributes: dlt$section_access_attributes, 
case 1..2 OF 

address: *dlt$68000_attributes, 
module_kind: dlt$module_kind, 
= 2 = 
section_ address: A dlt$section, 
kind: dlt$section_kind. 
casend, 
recend 
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dlt$section_kind = 

(dlc$code_section, 
dlc$binding_ section, 
dlc$working_ storage _ section, 
dlc$common_block, 
dlc$extensible _ working _ storage , 
dlc$extensible_common_block, 
dlc$line_table_section) 

dlt$section_ length = .. dlc$max_section_ length 

dlt$section_ offset = .. dlc$max_section_offset 

dlt$section_ ordinal = .. dlc$max_section_ordinal 

dlt$time = packed record { Time request return value. 

fill: .. 3fU6), 

case time_format: dlt$time_formats of 

= dlc$ampm_time = 

ampm: dlt$ampm_time, { HH:MM AM or PM 

= dlc$hms_time = 

hms: dlt$hms_time, { HH:MM:SS 

= dlc$millisecond_time = 

millisecond: dlt$millisecond_time, { HH:MM:SS.MMM 

casend, 
recend 

dlt$time_ formats = 

(dlc$default_time, 
dlc$ampm_time, 
dlc$hms_time, 
dlc$millisecond_ time) 

dlt$68000_ absolute = packed record 

load.address: dlt$68000_address, 

transfer_address: dlt$68000_ address, 

text: ALIGNED SEQ ( * ), { REP n OF byte 
recend 

dlt$68000_ address = .. dlc$maximum_68000_address 

dm_input_buffers_priority = high_priority { DVM priority 

dm .configuration .priority = medium_priority { DVM priority 

executive .extent = 1 .. 32750 

force, stat .reporting .status = 

(statistics _ report, issued, 
statistics.sap.not.found, 
sds_header_address_invalid) 
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hardware _ resource _ type = 

(mpb, 
cim, 
esci, 

reserved_3, 
reserved_4, 
reserved_5, 
reserved_6, 
pirn, 
pmm, 
smrn, 

reserved_10, 
reserved_ll, 
disc, 
mci, 
dci, 

slot_empty, 
lim, 
port, 
bank) 

ip_cmd_pkt_type = packed record 
case integer of 

command, 

status: 0..255, 

destination, 

source: 'cell, 

length, 

filler, 

checksum: 0.. 65535, 

cmd_status: 0.. 65535, 
destination_ adr, 
source_adr: integer, 
= 2 = 

cmd_wrd: array [0..6] of 65535, 

casend, 
recend 

itm _exp_ mask _ type = set of sc_status_range 

key_type = (numeric_key@, pointer_key@, string_key@) 

key _ record = record 

case key _ kind: key_type of 
= numeric_key@ = 

numeric: integer, 
= pointer _ key® = 

pointer: A cell, 
= string_key@ = 

string_type: "string ( * ), 
casend 
recend 
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light .status = packed record 

operational: .. 3, { always zero for operational state 

mpb_busy: boolean, { On for busy mpb 

test_ state: test_ status, 

failed_card: .. 7, { failed card slot number 

unused_byte: .. 0FF(16), { force word align 

recend 

mdu_ field _ type = 

(bin_str, 
bin_octet, 
char_octet, 
bin_int, 
bin_sint, 
bcd_char, 
format) 

memory _ owner _ type = .. 3fff(16) 

memory _ state _ type = 

(memory _ good, 
memory_fair, 
memory_poor, 
memory_congested) 

message _ size = .. 65535 

milliseconds = integer 

mpb _ status _ word = packed record 

access_code: type_of_memory, 

access_type: type_of_io, 

dtack_time_out: boolean, 

bus_lock_time_out: boolean, 

parity _ error: boolean, 

write_protect: boolean, 

dead_man_time_out: boolean, 

bit_not_used: boolean, 

manual_ reset: boolean, 

external_clear: boolean, 

a_c_low: boolean, 

temperature_shutdown: boolean, 

temperature_ warning: boolean, 

battery _ low: boolean, 
recend 

node = record 

balance: condition. range, { balance factor for sub-tree 

association: *node_control, { points to user data 

key: key _ record, 

llink: "node, { sub-tree links 

rlink: "node, 
recend 
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node _ control = record 

length: executive, extent, { length of the associated table 
dump_id: string (4), { validity check, should contain user value 

recend 

non_ empty .buffer = 1 .. max_chars_in_buffer 
non_ empty _ message _ size = 1 .. 65535 

number _of_ data _ byte _ types = 

(two_byte_statistic, 
four_byte_statistic, 
eight_byte_statistic) 

open _ statistics _ status = 

(statistics_ sap_ opened, 
statistics_sap_entry_exists, 
sds_header_not_included, 
open_ statis_ sap_ insuf _ resrc) 

ost$ampm_time = string (8) 

ost$date = record 

case date_format: ost$date_formats of 
= osc$month_date = 

month: ost$month_date, 
= osc$mdy_date = 

mdy: ost$mdy_date, 
= osc$iso_date = 

iso: ost$iso_date, 
= osc$ordinal_date = 

ordinal: ost$ordinal_date, 
= osc$dmy_date = 

dmy: ost$dmy_date 
casend, 
recend 

ost$date_ formats = 

(osc$default_date, 
osc$month_ date, 
osc$mdy_date, 
osc$iso_date, 
osc$ordinal_date, 
osc$dmy_date) 

ost$dmy_date = string (8) 

ost$hms_time = string (8) 

ost$iso_date = string (10) 



{ month DD, YYYY 
{ MM/DD/YY 
{ YYYY-MM-DD 
{ YYYYDDD 

{ DD/MM/YY 
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ost$mdy_date = string (8) 

ost$millisecond_time = string (12) 

ost$month_date = string (18) 

ost$name = string (osc$max_name_size) 

ost$ordinal_date = string (7) 

ost$time = record 

case time_format: ost$time_formats of 
= osc$ampm_time = 

ampm: ost$ampm_time, 
= osc$hms_time = 

hms: ost$hms_time, 
= osc$millisecond_time = 

millisecond: ost$millisecond_time, 
casend, 
recend 

ost$time_ formats = 
(osc$default_time, 
osc$ampm_time, 
osc$hms_time, 
osc$millisecond_time) 

pmt$program_name = ost$name 

port _ owner _ type = 

(device _ available, 
hdlc_owner, 
x25_owner, 
lcm_owner) 



{ HH:MM AM or PM 
{ HH:MM:SS 
{ HH:MM:SS.MMM 



pref_type = 

(absolute®, 
conditional®, 
yield®) 

priorities = .. max_priority 

qds_parm_type = record 

ip_number: 0..upper_ip_num, 
recend 

qps_parm_type = record 

dvmid_ptr: 'cell, 
recend 



{ stop (quit) port service 

{ card slot number of device 



{ stop (quit) port service 
{ pointer to dvmid block 
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report _ time _ type = record 

start: ost$hms_time, 
ending: ost$hms_time, 
recend 

root = record 

num_ tables: integer, 
num_ nodes: integer, 
dump_id: string (4), 
type_node: key_type, 
link: "node, 

recend 



{ HH:MM:SS } 
{ HH:MM:SS } 



{ number of tables in tree 
{ total number of nodes in the tree 

{ validity check, should contain user value 
{ how is tree accessed 



sap_id_type = .. 0ffff(16) 
sat$max_ dump _ size = .. 4096 

sat$recovery_ block = record 

procedure. address: "procedure, { pointer to code and static link address 
sa_dump_identifier: "cell, { sat$dump_identifier, ptr to dump control block 

previous_link: "sat$recovery_ block, { previous recovery block on stack 

recend 

sds_ header = record 

sds_bufl_ptr: "cell, { User defined collection buffers 

sds_buf2_ptr: "cell, 

group: statistics_group_type, 

log_msg_number: .. 0ffff(16), 

log_template_id: template_id_type, 

function_proc: statistics_function_procedure, 

display_proc: display_procedure, 

next_header: "sds_header, 

collecting: boolean, { Collecting statistics & next reporting 

collecting, bufl: boolean, { TRUE = buffer 1 FALSE = buffer 2 
recend 



sds _p arm _ type = 

ip_ number: 
num_ports: 
buf_lev: 
stat_q_size: 
cmd_q_size: 
load_module_ptr: 
load_module_len: 
recend 



record 



0..upper_ip_num, 
0..max_ number _ports, 
1 . .max_ buf _ level, 
16..max_stat_q_size, 
16..max_cmd_q_size, 
"cell, 
integer, 



{ Start Device Service 



{ card slot number of device 
{ number of I/O ports on dvc 

{ number of buffers in pool 

{ size of status queue 

{ size of command queue 

{ ptr to first byte of load module 

{ length of load module 



sps _parm_type 

ssr_tid: 
ip_ number: 
lim_num: 
lim_port: 
itm_exp_mask: 
recend 



record { Start Port Service 

taskid, { task id of ssr 

0.. upper _ip_num, { board slot number of device 

0..upper_lim_num, { LIM number if board is a CIM 

O..upper_port_num, { LIM port number 

itm_exp_mask_type, { mask for express intertask msg 
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software _ sap _ range = 1 .. 0ffff(16) 
stack_size = min_stack_size .. max_stack_size 

statistics _ function _ codes = 

(issue _ report_ and_ clear _buffers, 
clear.buffers, 
start_ collecting, 
stop.collecting, 
select.bufferl, 
select, buffer 2) 

statistics _ function _ procedure = 
"PROCEDURE ( { 

sds_hdr_ptr: "sds.header; 

function_ code : statistics _function_ codes; 

reason: statistics_reason_type; 

time: report_time_type; 

param: A cell; 
VAR status: statistics_function_status) 

statistics _function_ status = 
(stat_funct_ success, 
stat_ funct_ insuf _ resources, 
stat_funct_ sw_err) 

statistics, group _ type = 

(st_ summary, 
st_ expanded, 
st_debug) 

statistics .priority = medium_priority { Statistics priority 

statistics, reason, type = 

(periodic_report, 
start.reporting, 
stop.reporting, 
close, sap, 
forced, report) 

statistics .type = 
(comm.line, 
nw.solution, 
sw_ component) 

system.id.type = record 

upper: .. 0ffff(16), 
lower: integer, 
recend 
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system_status_table_type = 

(major_card_table_type, 
lim_table_type, 
port_table_type, 
smm_bank_table_type, 
pmm_ bank_ table _ type) 

task _ attributes = record 
stack_ allocation: stack_size, 
task_priority: priorities, 
preemptable: boolean, 
immediate _ control: boolean, 

recend 



template _id_ type = cme$min_template_id .. cme$max_template_id 

test .status = 
(no_fault, 
fault, 

test_in_progress, 
unused) 

threshold _ size = .. 7 

timer = record 

next_one: "timer, { next timer in queue 

length: .. 32767, { length of what follows 

code: .. 15, { identifying code 

tod: milliseconds, { time of day to pop 

period: milliseconds, { period,if periodic timer 

param: "cell, { parameter for subroutine 

proc: "procedure, { address of subroutine 

mark: integer, { = '!TIM' 
recend 

type_of_io = 

(no_io, 
read_io, 
write_io, 
intack_io) 

type _ of _ memory = 

(pmm_bus, 
itb_bus, 
mpb_ random, 
no_bus) 
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Procedure Types 



D 



Some of the procedures in chapter 10 have parameters that point to procedures. These 
nested procedures are defined in this appendix, using the same format as the 
procedures presented in chapter 10. Procedures from chapter 10 that contain nested 
procedures are: 



FIND_FIRST 

FIND_NEXT 

LOAD_ ABS_MODULE _ AND_PR0CE ED 

LOAD_CMD_PROCESSOR_AND_PROCEED 

LOAD_ENTRY_POINT_AND_PROCEED 

SFIND_FIRST 



SFIND_NEXT 

SFIND_WILD_CARDS 

START_NAMED_TASK_AND_PROCEED 

START_SYSTEM_TASK 

VISIT_ALL_NODES 



Below are nested procedure definitions: 

From FIND_FIRST, FIND_NEXT, SFIND.FIRST and SFIND.NEXT: 

Input ptK "cell 

Address of the table associated with the node being tested. 

param: "cell 

Address of the parameter being passed to this procedure. 
Output bool: boolean 

Indicates whether or not the table being tested satisfies the param 
parameter. 

From LOAD _ ABS .MODULE _ AND _ PROCEED: 
Input request_id: "cell 

Address of an identifier. If the calling procedure is making more than one 
request for the module, this identifies the request. 

absolute. module _ found: boolean 

Indicates whether or not the called module is found. 

smm_ address: "cell 

Starting address of the module in SMM. 

load .address: dlt$68000_ address 

Address where the module will be loaded. 

transfer. address: dlt$68000_ address 

Address at which module execution begins. 

byte .size: dlt$section_ length 

Size of the module in bytes. 

error .response: clt$status 

Any error messages from the Online Loader. 

Output None. 
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From LOAD_CMD_PROCESSOR_AND_PROCEED and LOAD_ENTRY_ 
POINT_AND_PROCEED: 

Input request _ id: 'cell 

Address of an identifier. If the calling procedure is making more than one 
request for the module, this identifies the request. 

entry _ point _ found: boolean 

Indicates whether or not the module entry point was found. 

entry _ address: "dlt$entry _ description 

Starting address of the module entry point. 

task_info: task _ attributes 

A record specifying stack size, priority, and whether or not the task is 
preemptible. 

error _ response: clt$status 

Any error messages generated by the Online Loader. 

module _ ptn dlt$load _ id _ ptr 

Address of a record containing information about the module. 

Output None. 

From SFIND_WILD_CARDS: 

input table: "cell 

Pointer to user table. 

params: 'cell 

Pointer to user parameters. 

Output quit _ processing: boolean 

Indicates whether wild card search is to be terminated. 
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From START_NAMED_TASK_AND_PROCEED: 

input request _ id: "cell 

Address of an identifier. If the calling procedure is making more than one 
request for the module, this identifies the request. 

task .started: boolean 

Indicates whether the task was started. 

task _ id: task_ptr 

The task identifier of the started task. 

error _ response: clt$status 

Any error messages generated by the Online Loader. 

Output None. 

From START. SYSTEM .TASK 

Input request.id: "cell 

User request identifier to link request and response. 

task .id: _ptr 

Task identifier of task started. 

Output None. 

From VISIT.ALL.NODES: 

input p: 'cell 

Pointer to user table. 

key: integer 

Associated node key. 

param: "cell 

Pointer to user parameters. 

Output more: boolean 

If TRUE, continue search; if FALSE, terminate search. 
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Vector Table Usage E 

The vector table is found in the first 400(16) bytes of DI memory. It is defined in 
common deck CMDVECT. The vector table is used as follows during CDCNET 
operation (refer to Motorola's M68000 User's Manual for more information). 

Vector Use 

Reset: Initial System Stack Pointer. Label RESETSP 

1 Reset: Initial PC 

2 Bus Error 

3 Address Error 

4 Illegal Instruction 

5 Zero Division 

6 Check Instruction 

7 Trap V Instruction 

8 Privilege Violation 

9 Trace 

10 Line 1010 Emulator. Unimplemented op code 

11 Line 1111 Emulator. Unimplemented op code 
12-23 Reserved for future enhancements by Motorola 

24 Spurious. For when the interrupt cycle has been started but cleared before 
completion 

25 Level 1 Interrupt Autovector. Reserved for possible use on the 68000 
Extension Bus. 

26 Level 2 Interrupt Autovector. Real Time Clock Interrupt 

27 Level 3 Interrupt Autovector. Software Timers and Clocks and Attention 
Switch 

28 Level 4 Interrupt Autovector. ISB Interrupts (scanned) 8 cards (Control Bus 
Vector) 

29 Level 5 Interrupt Autovector. Extension Bus 

30 Level 6 Interrupt Autovector. SSC (Serial Port) 

31 Level 7 Interrupt Autovector. Errors. Level 7 interrupts are non-maskable. 
"ACLOW" will indicate potential power failure, cause status to be saved, and 
then stop. "ERRORS" will include over-temperature condition. 

32 TRAP : fast_bg (also called maybe_bg) (background) 

33 TRAP 1 : sure_.bg 
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34 TRAP 2 : fast_fg (foreground) 

35 TRAP 3 : fire in. Saves registers. Controlled recovery point. If another 
vector is invoked then TRAP 3 sets up firewall. 

36 TRAP 4 : fire out. Resets firewall. If no task to preempt then it restores 
registers and returns from exception. 

37 TRAP 5 : set_interval 

38 TRAP 6 : set_ slice 

39 TRAP 7 : reserved for executive 

40 TRAP 8 : used by MCI 

41 TRAP 9 : reserved for I/O subsystem (for cards) 

42 TRAP A : reserved for I/O subsystem " 

43 TRAP B : reserved for I/O subsystem " 

44 TRAP C : reserved for I/O subsystem " 

45 TRAP D : used by DI Resident Debugger 

46 TRAP E : reserved for I/O subsystem " 

47 TRAP F : used by DVM 

48-63 Reserved for future enhancements by Motorola 

64 time slice 

66 time interval 

65, 67, SCCVECT (used by DI Debugger) (SCO 
69, 71, 
73, 75, 
77, 79 

68, 70, CIO User Interrupt Vectors 
72, 74, 
76, 78 

80-127 Expansion 

128-255 Available for major boards. Eight vectors alloted for each of 16 possible 
board slots. 
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Intertask Message Workcode Definitions 

Following are the workcodes for intertask messages, their respective values and 
explanations. 



Comdeck 



CMDITM 



CYBIL definitions: 



{ = = = = = = = = = = = = = = = = = = = = = == = = = = = = = = = = = „„ = = = = = „„ === 

{ Executive Intertask Message workcode Definitions 



,exec_iptfaiH 


= 0000(16) 


,exec_iptfail2 


= 0001(16) 


,exec_tskfai 1 1 


= 0002(16) 


,exec_tskfail2 


= 0003(16) 


.exec.extent.gone 


= 0004(16) 


,exec_stoptask 


= 0005(16) 


,exec_aborttask 


= 0006(16) 


exec.new.vector.owner 


= 0007(16) 


exec.jour.msg 


= 0008(16) 


exec.dest.f ailed 


= 0009(16) 


exec.excess.slice 


= 000a(16) 


exec.error 


* 000b(16) 


exec.end.of.day 


= 000c(16) 


exec.new.time 


= 000d(16) 


exec.per 1 od 1 c.t 1 mer 


= 000e(16) 


exec.af t er_ 1 nterva 1 


= OOOf (16) 


exec.at.time 


= 0010(16) 


exec.per iodic.after 


= 0011(16) 



{ Bus/address error in interrupt 

{ Other error in interrupt 

( Bus/address error in task 

{ Other error in task 

{ Memory extent vanished 

( Stop Task 

{ Abort Task 

{ New vector owner 

{ Journal message 

{ Destination failed 

{ Excess Slice 

{ MPB failure error for system .ancestor 

{ End of day message to timer task 

{ New time of day request for timer task 

( Periodic timer request for timer task 

{ After interval timer request for timer 

{ task 

{ Call at time request for timer task 

{ Periodic request after interval for 

{ timer task 



{ Command ME Intertask Message Workcode Definitions 



, c.me.msgcode 
.c.me.respcode 
,cjne_xport_msg 
, c_me_3b_msg 
,c_me_cp_task_abort 
,c_me_cp_task_stop 
, c.me.command.er r 
, c_me_load.cmd 



0014(16) { Command Processor I/F task 

0015(16) { Response to clp_process_ command 

0016(16) { Command from transport I/F 

0017(16) { Command from internet I/F 

0018(16) { Command processor abort 

0019(16) { Command processor stopped 

001AO6) { Command-ME processing error 

001BO6) { Load command processor 



{ Routing ME Intertask Message Workcode Definitions 



,rjne_f ul 1 .update. lords 
, r.me.part.update.lcrds 
.r.me.ridu.msg 
, r_me_3a_nw_update 



= 0030(16) { Update Least Cost Routing Data Store 

= 0031(16) ( Partial update to LCRDS 

= 0032(16) ( Routing Information Data Unit message 

» 0033(16) { Routing 3A Network Update message 



{ Error ME Intertask Message Workcode Definitions 



<- 



, err.me. internet_error 

< Independent File Access ME 



0039(16) { Internet error message 



, ifa.wkcode 



= 0040(16) { independent file access initialization 
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{.....-.-«.««== 

{ Console Driver Workcode Definitions 
(______„____„____________ — ____ — _ 

,oonsole$traffic » 0050<16) 

,console$conf iguration = 0051(16) 

,console$wnte_complete « 0052(16) 

,console$read_conplete = 0053(16) 

,console$read_correct = 0054(16) 

(.------. = = 

{ Online Loader Workcode Definitions 



{ Transmit message 

{ Startup configuration 

{ Completion of transmission sequence 

{ Message has been received 

{ Message received for editing 



{= 



,dlc$load_. 

,dlc$load. 

,dlc$load. 

,dlc$load, 

,dlc$start 

,dlc$start 

,dlc$load 

,dlc$loadj 

,dlc$load_i 



abs.de lay 
abs .proceed 
entry_point_delay 
entry _po l nt .proceed 
.task.delay 
task_proceed 
module.for.retain 
cmd_proc.de lay 
cmd_proc .proceed 



= 0060(16) { Load absolute module 

= 0061(16) { 

= 0062(16) { Load relocatable module 

= 0063(16) { 

= 0064(16) { Load relocatable module and 

= 0065(16) { Initialize as a task 

= 0066(16) { Load module 

= 0067(16) { Load a command.processor 

- 0068(16) 



DVM Intertask Message Command and Response Constants 



, dvm.response.base = 0100(16) { Offset for dvm responses 

.dvm.line.conf igure.res = 0101(16) { Line configured status 

.dvm.line.reconf igure.res = 0102(16) { Line configuration response 

.dvm.line.delete.res = 0103(16) ( Delete line response 

.dvm.line.enable.res = 0104(16) { Line enabled response 

.dvm.line.disable.res = 0105(16) { Line disabled response 

,dvm_data_1nput_res = 0106(16) { Input response 

,dvm_data_output_res = 0107(16) { Output response 

.dvm.terminate.io.res = 0108(16) { Line termination response 

.dvm.line.status.res = 0120(16) { Line status response 

.dvni.trap.res ■ 0121(16) { DVM trap occurred 

,dvm_timer_expired - 0122(16) { DVM heart beat timer expired 

.dvm.lme.suspended = 0123(16) { DVM has suspended service to an IP 

,dvm_l me.resumed ■= 0124(16) { DVM has resumed previously suspended 

{ service 

,dvm_!ine_ter-minated = 0125(16) { Service to a line has been terminated 

.dvm.ip.dead =■ 0126(16) { Intelligent peripheral has reported 

{ dead 

.dvni.restart.ip = 0127(16) { Request restart IP service 

.dvm.abort.lp - 0128(16) { Request abort IP service 

, dvm.unexpected. interrupt = 0129(16) { Unexpected interrupt 

{........................._................... — ....... 

{ HDLC Intertask Message Command and Response Constants 



hd 1 c.command.base 


= 0200(16) { 


hdlc_link_up.cmd 


' 0201(16) { 


hdlc.l ink_down.cmd 


= 0202(16) { 


hd 1 c.connect _omd 


= 0203(16) { 


hdlc.l ink_ldle.cmd 


' 0204(16) { 


hd l c.d i sconnect _cmd 


« 0205(16) { 


hdlc_low.buffer.cmd 


= 0206(16) { 


hd lc.nrm l .buffer _cmd 


= 0207(16) ( 


hdlc_wake_up.cmd 


= 0208(16) { 


hdlc_status.cmd 


= 0209(16) { 


hd 1 c.oonf i gure.cmd 


= 020b(16) { 


hd 1 c.reconf i gure.cmd 


= 020b(16) { 


hd 1 c.s tart _stats.cmd 


= 020d(16) { 


hdlc.report.stats.omd 


= 020e(16) { 


hdlc.stop_stats.cmd 


= 020f(16) { 


hd 1 c_ i _t 1 meout _omd 


= 0220(16) { 


hdlc_p_timeout.cmd 


= 0221(16) { 


hd l c.e.t i meout _cmd 


= 0222(16) { 


hdlc_ioc_timeout.cmd 


■= 0223(16) { 


hd 1 c.a.t i meout _cmd 


= 0224(16) ( 


hd l c_ i a.t i meout _cmd 


- 0225(16) { 


hdlc_rty_ex.cmd 


= 0226(16) ( 


hdlc_ret_ex.cmd 


= 0227(16) { 



HDLC ssr command base 

Physical link initialization 

Physical link down 

Logical link initialization 

Logical link idle 

Logical link disconnect 

Buffer levels are low 

Buffer levels are normal 

NOP message to wake up SSR (used by 3A) 

Provide sender with status information 

Physical and logical link configuration 

Same as confi gure.cmd 

Begin statistics collection 

Report statistics 

Discontinue statistics collection 

I frame time out 

P/F recovery attempt time out 

Error recovery attempt time out 

IP response time out 

Activity time out 

Inactivity time out 

Retry count exceeded 

Retransmit attempt count exceeded 
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{■= ========================================== 

{ ESC I Intertask Message Command and Response Constants 



.esci.command.base 


= 0300(16) 


, esci_startup.cmd 


= 0301(16) 


, esc 1 .shutdown _omd 


= 0302(16) 


, esc i_suspend.cmd 


= 0303(16) 


, esc i_resume.cmd 


• 0304(16) 


, esc i _stat 1 st 1 cs.cmd 


" 0305(16) 


, esc i_wakeup.cmd 


- 0306(16) 


, esci _swi tches_cmd 


= 0307(16) 


,esci_tdr_cmd 


= 0308(16) 


, esc i_diag.cmd 


= 0309(16) 


, esc i_nop.cmd 


= 030a(16) 


, esc i_dvmid.cmd 


= 030b(16) 


,esci_dump_cnd 


= 030c(16) 


, esc i_xsub.cmd 


= 030d(16) 


,esci_nures_res 


= 0320(16) 


, esc i .rcv.res 


= 0321(16) 


esci.xmit.res 


= 0322(16) 


esci.stistc.res 


= 0323(16) 


. esc i _swi tches.res 


= 0324(16) 


esci.tdr.res 


= 0325(16) 


esci.diag.res 


= 0326(16) 


esci.nop.res 


= 0327(16) 


esc i .dump.res 


= 0328(16) 


esci.xsub.res 


- 0329(16) 



( Command base for ESC I 



{==================================„„======„=======„= 

{ System Ancestor intertask Message workcode Definitions 



(= 



, sa.start_task_for.user 

,sa_reply 

, sa.dump.wr i te 

,sa_dump_timer 

,sa_dump_close 

, sa.djmp.restore 

, sa.dump.on 1 y 



= 0400(16) ( Start a task on behalf of another task 

- 0401(16) { Call start_system_task reply routine 

= 0402(16) { Write data to dump file 

= 0403(16) { Time out dump processing 

= 0404(16) { Close dump file 

* 0405(16) { Start dump processing and restore task 

= 0406(16) { Start dump processing (no restore) 



{========= — ===============_____====____==========____ 

{ System Audit Intertask Message Workcode Definitions 
<==============================___=========_________=== 

,sys_audit_checksum = 0450(16) { Checksun system memory 

,sys_audit_overf low = 0451(16) { Check user stack pointer for overflow 

,sys_audit_report_tne_mpb_status = 0452(16) { Check battery and temperature 



{============_.__== 

{ Mainframe Channel 
{===____=========== 



Interface Intertask Message Workcode Definitions 



,mci_startup 

, mc i .output .cornp 1 ete 

,mci_mput_recewed 

,mci_data_ava ilable 

, mc i .error .encountered 

,mci .Shutdown 

,mci_statistics 

, mc i .report.stat ist ics 

, mc i _ 1 1 nk.s tatus.change 

, mc i _t i mer.exp i rat i on 

.mci.log.message 

.mci.fai lure.detected 

,mci_run_diagnostics 



0501(16) { Specific MCI card 

0502(16) { PP has successful read 

0503(16) { PP has successful write 

0504(16) { Data is available for transfer 

0505(16) { An error was found on a write 

0506(16) { End processing 

0507(16) { Sender reauests statistics 

0508(16) { Announce statistics response 

0509(16) { New link status 

050a(l6) ( Response timer has expired 

050b(16) { Message is to be logged 

050c(l6) ( Failure detected 

050d(l6) { Run diagnostics 



{======================____============_____==_=_====_____= 

{ initialization ME Intertask Message workcode Definitions 
{_____._ — ========= — ===-=====--====.====____=_====______ 



, ime_pdu 

, lme.transient.timer.expired 

, ime.init 

, ime.last.itm 

, ime.request.empty.itm.q 

, lme.inactive.timer.expired 



= 0601(16) { 3A indication parameters 

= 0602(16) { Transient task timer expired 

= 0603(16) { Transient task initialization 

= 0604(16) { Transient task's last message 

= 0605(16) { Request for ime.last.itm [»venfy'«] 

= 0606(16) { Mam task'timer expired 



Revision A 



Intertask Message Workcode Definitions F-3 



( XEROX Transport Intertask Message workcode Definitions 



,xt .transmit 

,xt .retransmit 

.xt.expedited.retransmit 

,xt_inaotivity 

.xt.cid.timer 

,xt_incoming_data_to_cep 

.xt.incoming.data.to.sap 

.xt.local.disconnect 

.xt.set.up.timer 



0700(16) { Transmit delayed data 

0701(16) { Retransmit normal data 

0702(16) { Retransmit expedited data 

0703(16) { Send a probe or kill the connection 

0704(16) { Kill previously disconnected con'ctn 

0705(16) { Process packet for a connection 

0706(16) { Process packet for a sap 

0707(16) (Kill connection due to local action 

0708(16) { Set up connection timer 



( CDCNET Statistics Manager Message Workcode Definitions 



, csm. i ssue.stat i st i cs_req 
,csm .process. t lmer.req 



= 0800(16) { Reauest statistics to be reported 
= 0801(16) { Process statistics timer call 



{ Operator Support Application intertask Message workcode Definitions 



, osa.f rom.operator 

,osa_from_transport 

, osa_f rom .internet 

, osa.term mate.osa 

, osa.conf igure.osa 

, osa.cmd.response.t i me.exp i red 

, osa_cmd_proc.cmd. i nd i cat i on 

,osa_Droc_response_time_expired 

,osa_alarm_data 

.osa.format .message 



= 850(16) { Command indication from operator 

- 851(16) { Indication from transport 
= 852(16) { Indication from internet 
= 853(16) (Kill OSA 

= 854(16) ( Initialize OSA 

= 855(16) { Command time limit expired 

= 856(16) { Command notice to OSA command processor 

- 857(16) { Broadcast command time limit expired 
= 858(16) { Alarm indication from Dep Alarm ME 
= 859(16) ( Formatting workcoOe 



{ K Display Supervisor Intertask Message Workcode Definitions 



(= 



.kdisp.wkcode 



888(16) { Used to bring up k_display_supervisor 



{„„„„„=„„„„„=„=„ = != „ = „„„„ = „„.„ = 

{ Log Support Application Intertask Message Workcode Definitions 



, lsa_log_request_workcooe = 900(16) 

, lsa.log.connect.retry =901(16) 

, lsa.alarm.connect .retry = 902(16) 

, lsa.log.directory.indication = 903(16) 

, lsa.alarm.directory.mdicat ion = 904(16) 

, lsa.log.transport.mdication = 905(16) 

, lsa.alarm.transport.indication = 906(16) 

, lsa.l og.format ting. workcode = 907(16) 



{ Request for logging 

{ Retry due to transport connect failure 

{ Retry due to transport connect failure 

{ Logging directory indication 

{ Alarming directory indication 

{ Logging transport indication 

{ Alarming transport indication 



{ SSR Intertask Message 



{= 



,ssr_imt_ok_workcode 
, ssr_ i n i t .error _workcode 
, ssr_ in i t _start.port_service.err 
, ssr_ i n i t .queue.c im_command_err 
, ssr.shutdown .error .workcode 
,ssr_shutdown_ok_workcode 
.ssr.reset.t imer_req_workcode 
.ssr.t lmeout .workcode 



980(16) 


{ SSR 


981(16) 


( SSR 


982(16) 


{ SSR 


983(16) 


{ SSR 


984(16) 


{ SSR 


985(16) 


{ SSR 


986(16) 


{ SSR 


987(16) 


{ SSR 



initialization completed ok 
initialization error 
start port service error 
queue cim command error 
shutdown error 
shutdown ok workcode 
reset request workcode 
timed out workcode 
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{ Configuration Status Reporter Intertask Message Workcode Definitions 
,csr_report_time = 1050(16) { Rime to report configuration status 

{ Clock ME Inter-task Message Workcode Definitions 

{«« = = = = = «« ».»«»««« = „ = . = *„«*„„ 

,ck_sync_clock = 1060(16) { Synchronize clock 

,ck_sync_complete = 1061(16) { Synchronization attempt complete 

,ck_stop_independent_clock - 1062(16) { Cancel independent clock on this system 

,ok_disconnect_connection = 1063(16) { Disconnect this connection 

,ck_start_clock = 1064(16) { Start independent clock on this system 

,ck_clock_started = 1065(16) { Independent clock started 

,ck_clock_s topped = 1066(16) { Independent clock stopped 
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DI Reset Codes 



G 



Table G-l lists all DI reset codes, in numerical order. For more information on the DI 
reset codes, refer to appendix B of the CDCNET Network Analysis manual. 

Table G-l. DI Reset Codes 



Major 
Category 



Code 
Name 



Hardware power _up_ reset 
manual _ reset 
halt_memory_fault 
dead_man_time_out 



Code Component Generating 

Number Reset Code 



00(16) 
02(16) 
03(16) 
04(16) 



MPB ROM 
MPB ROM 
MPB ROM 
MPB ROM 



Software load_ software _ too _ big 10(16) 

improper_first_module 11(16) 

unsatisfied_ external 12(16) 

sysconfig_not_ loaded 13(16) 

post_load_routines_not_found 14(16) 

reset_at_end_of_quiesce 15(16) 

unrecognizable _object_ text 16(16) 

duplicate_entry_point 17(16) 

task_error_no_recovery_proc 18(16) 
task_error_exceed_max_recovers 19(16) 

task_error_unrecoverable 1A(16) 

no_configuration_file_obtained 1B(16) 

confLguration_ file _read_ error 1C(16) 

not_enough_memory_for_buffers 1D(16) 

identification_ record_ expected IE (1 6) 

unexpected _ idr _ encountered 1 F( 1 6) 

premature_eof_on_file 20(16) 

absolute_length_too_large 21(16) 

invalid_ object_ text_ version 22(16) 

invalid_module_kind 23(16) 

invalid_ module _ attribute 24(16) 

invalid_section_ ordinal 25(16) 

duplicate_ section 26(16) 

invalid_section_kind 27(16) 

invalid_ allocation_ alignment 28(1 6) 

invalid_offset 29(16) 

storage_allocation_failed 2A(16) 

undefined_ section 2B(16) 

reference_outside_of_section 2C(16) 

invalid_address_kind 2D(16) 
invalid_ number_of_bytes_spanned 2E(16) 
transfer_sym_entry_pt_not_found 2F(16) 

parameter _verification_ error 30(16) 

loader_table_not_found 31(16) 

kill_system_with_dump 32(16) 

kill_system_without_dump 33(16) 



Initialization Bootstrap 

Initialization Bootstrap 

Initial Loader 

Initial Loader 

Initial Loader 

Initialization Bootstrap 

Initial Loader 

Initial Loader 

System Ancestor 

System Ancestor 

System Ancestor 

Configuration Procurer 

Configuration Procurer 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

Loader 

KILL_ SYSTEM 

command 

KILL_ SYSTEM 

command 



(Continued) 
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Table G-l. DI Reset Codes (Continued) 



Major 


Code 


Code 


Component Generating 


Category 


Name 


Number 


Reset Code 




stop_ executive 


34(16) 


Executive - S/W error 




module_checksum_is_invalid 


35(16) 


System Audits 




software_dead_stop 


36(16) 


Dead stop - S/W error 




smm_ double _ bit_ error 


37(16) 


Executive - H/W error 




ac_low_error 


38(16) 


Executive - H/W error 




temperature. shutdown_ error 


39(16) 


Executive - H/W error 




reset_from_ debugger 


3A(16) 


Hardwired in Debugger 




overflowed, stack 


3B(16) 


Executive/System Audits 




system_data_not_found 


3C(16) 


Initial loader 




boot_file_media_mismatch 


3D(16) 


Boot startup code 




cybil_ detected, error 


3E(16) 


CYBIL runtime routines 
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Index 



Index 



A 








Command packet 9-7 
Command processor 4-1 
Commands 


Accessing and updating the hardware 


CANCEL 5-3 


device status tables 


5-5 






CHANGE_ELEMENT_STATE 5-4 


Acquisition and release of 


a hardware 


DEFINE 5-3 


device 5-5 








DEFINE_CIM_INTERFACE 5-3 


Asynchronous line 5-4 






START 5-4 


Attribute flag 








START. TRUNK 5-3 


Immediate control 


3-3 






STOP 5-4 


Preemptible/not preemptible 


3-3 


STOP_TRUNK 5-3 










Communication line 4-1; 8-5 










Communications interface module 5-1 


B 








Configuration procurer 2-1 
Control blocks 9-1 
Controlware 9-1 


Base system software 


i-i; 


4-1; 


10-1 


CPU 3-1,2,4 


Binary tree solution 


6-1 






CRC 8-1 


Board 2-1 








CSM 4-1 


Map table 2-1 








CYBIL 3-2 


Boot file 2-1,3 








Common types C-l 


Boot image 2-1,3 








Constants C-l 


Bootstrap 2-1 
Buddy system 1-1 








Cyclic redundancy check 8-1 


Buffer B-l 










Chain 2-2; 9-5 








D 


Data 3-5 










Data count 3-5 










Data offset 3-5 








Device control block 9-3 


Descriptor 3-5 








Device identifier 9-5,6 


Pointer 3-5 








Device interrupt management 1-1 


Pool 2-2 








DI 1-1; 2-1,2; 5-1 


Priority 3-5 








Reset 8-9 


State 3-6 








Reset codes G-l 


Threshold 3-6 








DI debugger interface 10-1 


Usage count 3-5 








Distributed processing 1-1 
Dump 2-1,2 
DVCB 9-3,4 


c 








DVM 8-6; 9-1 



CDCNET Network Analysis Manual 5-1 
CDCNET statistics manager 4-1 
CDCNET Troubleshooting Guide 2-2 
CDNA 9-1 

Link layer 9-1 

Physical layer 9-1 
Channel interface 8-8 
Checkpoint 3-1 
Checksum 7-1 
CIM 5-1,3; 8-5; 9-6,7 

Bus error handler 8-5 

Failure table 8-5 

Modem signal monitor 8-5 

Monitor 8-5 

Spurious interrupt handler 8-5 

68000 address error handler 8-5 

68000 exception handler 8-5 



Command packets 9-7; B-3 
Data transfer services 9-2 
Device control services 9-1 
Diagnostic services 9-2 
Failure management task 8-6 
Interrupt processor 8-6 
Interrupt routines 8-5 
Major data structures 9-4 
Order of events 9-3 
Status ITMs 9-7; B-3 
Status request services 9-1 
Task 8-5 
DVMID 9-5,6 
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Entry definition record ' 



LST 



E 



Entry definition record 2-2 

Entry point 3-4; 7-1 

Entry point table 
Tree-structured 2-2 

ESCI 5-3; 8-6; 9-7 

Bus error handler 8-6 
Firmware 8-6 

Spurious interrupt handler 8-6 
68000 address error handler 8-6 
68000 exception handler 8-6 
68000 level six interrupt handler 

ESCI SSR 8-6 

Ethernet 8-6 
Controller 8-6 

EXEC_MPB 2-3 

Executive 2-1,2,3; 3-1,2,4,5,8,10,11 

Executive error table 8-4,9; B-7 



8-6 



Failure 

Detection 8-2 

Logging 8-9,10 

Logging thresholds 8-10 

Recovery 8-1,2 

Reporting 8-2 
Failure management 1-1; 8-1 

General model 8-3 
Failure management software 8-1,2 
Failure management subsystems 

CIM 8-3,5 

ESCI 8-3,6 

Failure management task 8-3 

Failure table 8-3 

Fault handlers 8-3 

MCI 8-3,8 

MPB 8-3,4 
Failures 

Unclassified 8-1 
Field replaceable unit 8-1 
FIFO 3-2 
Firewall 3-1 
First in, first out 3-2 
FRU 8-1 
Functions 

ABS, MAX, MIN 10-2,8 

CONVERT_INTEGER_TO_ 
POINTER 10-2,28 

CONVERT_POINTER_TO_ 
INTEGER 10-2,28 

FIELD_SIZE 10-2,41 

FIND 6-1; 10-5,42 

FIRST_BYTE_ADDRESS 3-8; 10-3,46 

GET_CIM_NUMBER 9-1; 10-2,54 

GET_FIRST_BYTE 3-8; 10-3,57 

GET_LAST_BYTE 3-8; 10-3,58 



GET_MESSAGE_LENGTH 3-8; 

10-3,61 
I_COMPARE 10-2,71 
I_COMPARE_COLLATED 10-2,72 
NAME_MATCH 10-2,92 
UNUSED_STACK_ 3-2; 10-2,149 



G 



Gateway 1-1 

General concepts relating to the 
Executive 3-1 



H 



Handshake 5-4 
Hardware 

Environmental warnings 8-4 

Hard failures 8-1,9 

Soft failures 8-1,9 

Status register 8-2,9; 9-5 

Timer 2-2 
Hardware device interfaces 10-2 
HDLC 5-4; 8-1 
Help request 2-1 
High-level data link control 8-1 
Host system 2-1 



I/O 9-1 

Identification record 2-2 
Initial loader 2-1,2,3; 5-1 
Initialization 1-1; 2-1; 8-9 
Initialization bootstrap 2-1 
Intelligent peripheral 3-1; 9-1,2 
Internal system bus 8-6 
Interrupt handlers 8-2 
Interrupt service routine 3-1,2,4 
Intertask message 3-1 

Workcode definitions F-l 
IP 3-1; 9-1,3,7 
ISB 8-6 
ITM 3-1,2,10; 9-3 



Layer software 1-1 
LIM 8-1,5; 9-6 

Ports 8-5 
LIM status table 5-1 
Line interface module 5-1 
Log support application 4-1 
LST 5-1 
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Main bootstrap controller 



Procedures 



M 



Main bootstrap controller 2-1 
Mainframe channel interface 3-1 
Major card status table 5-1 
Management entity 1-1; 6-1 
MCI 3-1; 5-3; 8-3,8 

Driver error interrupt handler 8-8 

SSR 8-8 
MCST 5-1 
MDI 2-1 
Memory 

State 3-6 

System 3-5 
Memory extent 3-6 
Memory interfaces 10-2 
Memory management 3-1,5 
Memory pool 2-2 
Message management 
Modem 8-1 
Module 

deloader 7-1 

loader 7-1 

use count 7-1 
MPB 2-3; 5-3,4; 8-4; 

Bus error handler 

Indicator lights 2-2 

Level seven interrupt handler 8-4 

Spurious interrupt handler 8-4 
MPB RAM B-9 



3-1,8; 10-2 



9-4,7 
8-4 



N 



Network solution 4-1 



o 



Offline switch 5-2 
On-board diagnostics 5-1,2 
Online diagnostics 5-3,4; 9-2 
Online loader 7-1 

Interlock feature 7-1 
Online loader interface 10-3 
Operator alarms 3-6 



PBST 5-1 

PDU 3-6 

PMM 2-3; 



5-3,4; 8-4 



PMM bank status table 

Port 9-1,6 

Port status table 5-1 



5-1 



Procedure 

Conventions 10-1 

Logical groups 10-2 
Procedure types D-l 
Procedures 

ABORT_SYSTEM 10-2,6 

ABORT_TASK 3-4; 10-5,7 

APPEND 3-8; 10-3,9 

ASSEMBLE 3-8; 10-3,10 

BROADCAST 3-8; 10-3,11 

BUILD_HEADER_IN_PLACE 3-8; 
10-3,12 

BUILD_STATISTICS_MSG_ 

HEADER 4-2; 10-4,13 
CALL_AFTER_INTERVAL 3-11; 

10-5,14 
CALL_AT_TIME 3-11; 10-5,15 
CALL_PERIODIC 3-11; 10-5,16 
CANCEL_TIMER 3-11; 10-5,17 
CHANGE _DVM_ INTERRUPT 9-2; 

10-2,18 
CHANGE_DVM_TASK_ID 9-1; 

10-2,19 
CHANGE_TIMER_OWNER 3-11; 

10-5,20 
CHECKSUM_NEXT_MODULE 7-2; 

10-4,21 
CHKSUM _ IP_ COMMAND. 

PACKET 9-2; 10-2,22 
CLEAR_ALLOCATE 3-7; 10-3,23 
CLE AR_ MEMORY 3-7; 10-3,24 
CLEAR_ WRITE _ PROTECT 3-7; 

10-3,25 
CLOSE _ STATISTICS. SAP 4-2; 

10-4,26 
CLOSE_STATUS_SAP 5-5; 10-4,27 
COPY 3-8; 10-3,30 
DEAD_STOP 10-2,31 
DECREMENT_MODULE_USE_ 

COUNT 7-2; 10-4,32 
DELAY_PROCESSING 3-4,11; 

10-5,33 
DEVICE. STARTED 9-1; 10-2,34 
DI_DEBUG 10-2,35 
DI_DEBUG_INIT 10-2,36 
DUMP_CLOSE 2-2; 10-4,37 
DUMP_IP_MEMORY 9-1; 10-2,38 
DUMP_ WRITE 2-2; 10-4,39 
FG_AFTER_INTERVAL 10-14 
FG_AT_TIME 10-15 
FG_CANCEL_TIMER 10-17 
FG_LONG_ BUFFERS 10-59 
FG_ MEMORY 10-60 
FG_MPB_EXTENT 10-62 
FG_PERIODIC 10-16 
FG_PMM_EXTENT 10-65 
FG_RELEASE_MESSAGE 10-110 
FG_SHORT_BUFFERS 10-66 
FG_TO_EXPRESS 10-119 
FG_TO_NORMAL 10-120 
FG_TRIM 3-8; 10-3,40 
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FG_WAKE_UP 10-153 
FIND_FIRST 6-1; 10-5,43 
FIND_FREE_NODE 6-1; 10-5,44 
FIND_NEXT 6-1; 10-5,45 
FIRST_NODE 6-1; 10-5,47 
FORCE_STSTISTICS_ 

REPORTING 4-2; 10-4,48 
FRAGMENT 3-8; 10-3,49 
GEN_DATA_FIELD 3-8; 10-3,50 
GEN_TEMPLATE_ID 3-8; 10-3,51 
GET_CARD_TYPE_AND_ 

ADDRESS 5-5; 10-3,52 
GET_CIM_BOOT_SOURCE 9-1; 

10-2,53 
GET_DATA_FIELD 3-8; 10-3,55 
GET_EXPRESS 3-10; 10-5,56 
GET_LONG_BUFFERS 3-8; 10-3,59 
GET_MEMORY 3-7; 10-3,60 
GET_MPB_EXTENT 3-7; 10-3,62 
GET_MSG 3-10; 10-5,63 
GET_NEXT_STATUS_SAP 5-5; 

10-4,64 
GET_PMM_EXTENT 3-7; 10-3,65 
GET_SHORT_BUFFERS 3-8; 10-3,66 
GET_SIZE_N_ADDR 3-8; 10-3,67 
GET_STATUS_RECORD 5-5; 10-4,68 
GET_STATUS_SAP 5-5; 10-4,69 
GROW 6-1; 10-5,70 
I_SCAN 10-2,73 
I_TRANSLATE 10-2,74 
INCREMENT_MODULE_USE_ 

COUNT 7-2; 10-4,75 
INIT_ROOT 6-1; 10-5,76 
INITIALIZE_STATISTICS_ 
RECORD 4-2; 10-4,77 

LOAD_ABS_MODULE_AND_ 
DELAY 7-2; 10-4,78 

LOAD_ABS_MODULE_AND_ 
PROCEED 7-2; 10-4,79 

LOAD_CMD_PROCESSOR_AND_ 
DELAY 7-2; 10-4,80 

LOAD_CMD_PROCESSOR_AND_ 
PROCEED 7-2; 10-4,81 

LOAD_ENTRY_POIINT_AND_ 
PROCEED 7-2; 10-4,83 

LOAD_ENTRY_POINT_AND_ 
DELAY 7-2; 10-4,82 

M_RELEASE 3-8; 10-3,84 

MAYBE_EXPRESS 10-56 

MAYBE_LONG_BUFFERS 10-59 

MAYBE_MEMORY 10-60 

MAYBE_MPB_EXTENT 10-62 

MAYBE_MSG 10-63 

MAYBE_PMM_EXTENT 10-65 

MAYBE_SHORT_BUFFERS 10-66 

MAYBE_TASK 10-5,85 

MDU_TO_ASCII 10-2,86 

MESSAGE.DEQUEUE 3-10; 10-3,87 

MESSAGE_ENQUEUE 3-10; 10-3,88 

MODIF Y_ WRITE _ PROTECT. 
BYTE 3-7; 10-3,89 



MODIFY. WRITE_PROTECT_LONG_ 

WORD 3-7; 10-3,90 
MODIFY_WRITE_PROTECT_ 

SHORT. WORD 3-7; 10-3,91 
NEW_INTERRUPT 3-4; 10-5,93 
NEW_PRIORITY 3-4; 10-5,94 
NOPREMPT 3-4; 10-5,95 
OKPREMPT 3-4; 10-5,96 
OPEN_STATISTICS_SAP 4-2; 

10-4,97 
OPEN_STATUS_SAP 5-5; 10-4,98 
PCOPY 3-8; 10-3,99 
PICK 6-1; 10-5,100 
PMP_GET_DATE 3-11; 10-5,101 
PMP_GET_TIME 3-11; 10-5,102 
PREFIX 3-8; 10-3,103 
PUT_STATUS_RECORD 5-5; 

10-4,104 
QUEUE _IP_ COMMAND 9-2; 

10-2,105 
READ_BCD_CLOCK 3-11; 10-5,106 
READ.CLOCK 3-11; 10-5,107 
READ_SR0_FROM_IP 9-2; 10-2,108 
RELEASE_HARDWARE_ 

DEVICE 5-5; 10-3,109 
RELEASE.MESSAGE 3-8; 10-3,110 
REQUEST. DIAGNOSTIC. 

ENTRY 5-5; 10-3,111 
REQUEST.HARDWARE. 
DEVICE 5-5; 10-3,112 

RESET.DI 2-2; 10-4,113 

RESET.RECOVERY. 
PROCEDURE 2-2; 10-4,114 

RESTART.PORT.SERVICE 9-1; 
10-2,115 

RESTORE_DVM_INTERRUPT 9-2; 
10-2,116 

RESTORE.TASK 3-4; 10-5,117 

SEND.CR0_TO.IP 9-2; 10-2,118 

SEND.EXPRESS 3-10; 10-5,119 

SEND.NORMAL 3-10; 10-5,120 

SET.BCD.CLOCK 3-11; 10-5,121 

SET.BUFFER.CHAIN.OWNER 3-7; 
10-3 122 

SET.MEMORY. OWNER 3-7; 
10-3,123 

SET.RECOVERY.PROCEDURE 2-2; 
10-4,124 

SET.WRITE.PROTECT 3-7; 
10-3,125 

SFIND 6-1; 10-5,126 

SFIND.FIRST 6-1; 10-5,127 

SFIND.NEXT 6-1; 10-5,128 

SFIND. WILD. CARDS 6-1; 10-5,129 

SGROW 6-1; 10-5,130 

SIGNAL(n)/ACQUIRE(n) 3-4; 10-5,131 

SPICK 6-1; 10-5,132 

START.DEVICE.SERVICE 9-1; 
10-2 133 

START.NAMED.TASK.AND. 
DELAY 7-2; 10-4,134 



Index-4 Base System Software 



Revision A 



Procedures and functions 



Task_ptr 



3-9; 



START_NAMED_TASK_AND_ 
PROCEED 7-2; 10-4,135 

START_PORT_SERVICE 9-1; 
10-2,136 

START_SYSTEM_TASK 3-4; 
10-4,137 

START_TASK 2-2; 3-4; 10-5,138 

STOP_ DEVICE .SERVICE 9-1; 
10-2,139 

STOP_PORT_ SERVICE 9-1; 10-2,140 

STOP_TASK 3-4; 10-5,141 

STRIP 3-8; 10-3,142 

STRIP_IN_PLACE 3-9; 10-3,143 

SUBFIELD 3-9; 10-3,144 

SUSPEND 3-4; 10-5,145 

TIME 3-11; 10-5,146 

TRANSLATE_MESSAGE 
10-3,147 

TRIM 3-9; 10-3,148 

VALIDATE_SECTION_ 
ADDRESS 7-2; 10-4,150 

VISIT_ALL_NODES 6-1; 10-5,151 

WAIT 3-4; 10-5,152 

WAKE_UP 3-4; 10-5,153 

YIELD 3-4; 10-5,154 
Procedures and functions 10-1 
Program counter 7-1 
Program naming convention 2-2,3 
Protocol data unit 3-6 
PST 5-1 



3_ 



QCB 3-2,10 

Express message 3-10 
Normal message 3-10 

Queue 

Command 9-5,7 
Control block 3-2; B-10 
Express message 3-1; 9- 
Management 3-1,10; 10- 



■6 
3 

Normal message 3-1; 9-6 
Status 9-5,7 
Quicklook diagnostics 



R 



2-1 



Random access table 6-1 
Read parity error 8-1 
Realtime response 3-1 
Recovery block 2-2 
Recovery procedure 2-2 
Recovery stack 2-2 
Register 3-1,2 

Save area 3-2 
ROM code 2-1 
RS449 5-1 



SAP 4-1; 5-5 

Management 4-1 
SBST 5-1 
SDS 4-1 
Semaphore 3-4 
Service access point 4-1 
Single bit error 8-1 
SMM 2-1,3; 5-3,4; 8-4; 9-3,4 
SMM bank status table 5-1 
Software error code 2-2 
SSR 9-1,6 
Stack 3-1 

System 3-1 

User 3-2 
State 

Hardware device 5-2 

Suspend 3-4 

Transitions 5-2,4 

Wait 3-4 
Statistics 1-1 

Collection 4-1 

Group type 4-1 

Reporting 4-1 
Statistics data structure 4-1 
Statistics management 4-1; 10-3 
Status 

Hardware device 5-2,4 
Status management 5-1; 10-3 
Status packet 9-7 
Supervisor 

Call 3-1 

State 3-1 
System ancestor 2-1,2; 3-4; 5-1; 8-4 
System ancestor interface 10-3 
System audit 8-4 

System configuration table 2-2; B-ll 
System status table 5-5 



1-1 
1-1 



3-2,10; B-13 



Table management 

Device status 1-1 

Integer-keyed 

String-keyed 
Task 3-1,2,3 

Child 3-2 

Control block 

Parent 3-2 

Preemption 3-1,4 

Priority 3-1,4 

Program counter 3-2 

Recovery 3-3 

State 3-4 

Status register 3-1 
Task management 3-1,4; 
Task_ptr 3-2 
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Taskid X.25 



Taskid 3-2; 9-6 U 

TCB 3-2,3 
TDI 2-1 



Timer management 3-1,11 User state 3-1 

Timer services 10-4 

TIP 1-1; 9-1,6 

Transfer address 2-1 V 

Translation to modules 7-1 

Tree 

key g.! Vector table 2-2; E-l 

node 6-1 

root 6-1 Y 

Tree (table) management 6-1; 10-4 -^ 



X.25 5-4 
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Base System Software 60462410 A 

We value your comments on this manual. While writing it, we made some assumptions about who would use 
it and how it would be used. Your comments will help us improve this manual. Please take a few minutes 
to reply. 

Who are you? How do you use this manual? 

D Manager D As an overview 

□ Systems analyst or programmer □ To learn the product or system 

□ Applications programmer Q For comprehensive reference 

□ Operator D For quick look-up 

□ Other 

What programming languages do you use? 



How do you like this manual? Check those questions that apply. 



No 

□ Is the manual easy to read (print size, page layout, and so on)? 

□ Is it easy to understand? 

□ Does it tell you what you need to know about the topic? 

□ Is the order of topics logical? 
D Are there enough examples? 

□ Are the examples helpful? (□ Too simple? □ Too complex?) 

□ Is the technical information accurate? 

□ Can you easily find what you want? 

□ Do the illustrations help you? 

Comments? If applicable, note page and paragraph. Use other side if needed. 



D 


D 


D 


D 


D 


a 


D 


a 


D 


a 


□ 


a 


□ 


□ 


□ 


□ 


□ 


□ 



Would you like a reply? Q Yes D No 



From: 



Name Company 



Address Date 



Phone 



Please send program listing and output if applicable to your comment. 
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